curl "https://api.usegately.com/api/v1/email/logs?type=transactional&limit=10" \
-H "Authorization: Bearer gately_YOUR_API_KEY"
const response = await fetch(
'https://api.usegately.com/api/v1/email/logs?type=transactional&limit=10',
{
headers: {
'Authorization': 'Bearer gately_YOUR_API_KEY',
},
}
);
const { logs, total } = await response.json();
import requests
response = requests.get(
'https://api.usegately.com/api/v1/email/logs',
headers={'Authorization': 'Bearer gately_YOUR_API_KEY'},
params={'type': 'transactional', 'limit': 10},
)
print(response.json())
{
"logs": [
{
"id": "a1b2c3d4-e5f6-...",
"to_email": "user@example.com",
"from_email": "hello@yourdomain.com",
"subject": "Welcome to Acme!",
"email_type": "transactional",
"status": "sent",
"message_id": "0100019fc2ed413a-69325b2f-...",
"open_count": 2,
"click_count": 1,
"sent_at": "2026-08-02T10:30:00Z",
"opened_at": "2026-08-02T10:35:00Z",
"tags": { "type": "welcome" }
}
],
"total": 42,
"limit": 10,
"offset": 0
}
{
"error": "Invalid or missing API key"
}
Transactional Email
Email Logs
Retrieve a paginated list of transactional emails sent from your project.
GET
/
api
/
v1
/
email
/
logs
curl "https://api.usegately.com/api/v1/email/logs?type=transactional&limit=10" \
-H "Authorization: Bearer gately_YOUR_API_KEY"
const response = await fetch(
'https://api.usegately.com/api/v1/email/logs?type=transactional&limit=10',
{
headers: {
'Authorization': 'Bearer gately_YOUR_API_KEY',
},
}
);
const { logs, total } = await response.json();
import requests
response = requests.get(
'https://api.usegately.com/api/v1/email/logs',
headers={'Authorization': 'Bearer gately_YOUR_API_KEY'},
params={'type': 'transactional', 'limit': 10},
)
print(response.json())
{
"logs": [
{
"id": "a1b2c3d4-e5f6-...",
"to_email": "user@example.com",
"from_email": "hello@yourdomain.com",
"subject": "Welcome to Acme!",
"email_type": "transactional",
"status": "sent",
"message_id": "0100019fc2ed413a-69325b2f-...",
"open_count": 2,
"click_count": 1,
"sent_at": "2026-08-02T10:30:00Z",
"opened_at": "2026-08-02T10:35:00Z",
"tags": { "type": "welcome" }
}
],
"total": 42,
"limit": 10,
"offset": 0
}
{
"error": "Invalid or missing API key"
}
Headers
string
required
Bearer YOUR_API_KEYQuery Parameters
string
Filter by email type. Values:
transactional, campaign, magic_link, welcome, invite.number
default:"50"
Number of results to return. Max
100.number
default:"0"
Number of results to skip for pagination.
Response
array
Array of log objects.
Show Log object
Show Log object
string
Log entry UUID.
string
Recipient email address.
string
Sender address used.
string
Email subject.
string
Type of email —
transactional, campaign, magic_link, welcome, or invite.string
sent, delivered, bounced, or failed.string
Provider message ID.
number
Number of times the email was opened.
number
Number of tracked link clicks.
string
ISO 8601 timestamp of when the email was sent.
string
Timestamp of first open (if opened).
object
Custom metadata tags attached at send time.
number
Total count of matching log entries.
number
Page size used for this request.
number
Offset used for this request.
curl "https://api.usegately.com/api/v1/email/logs?type=transactional&limit=10" \
-H "Authorization: Bearer gately_YOUR_API_KEY"
const response = await fetch(
'https://api.usegately.com/api/v1/email/logs?type=transactional&limit=10',
{
headers: {
'Authorization': 'Bearer gately_YOUR_API_KEY',
},
}
);
const { logs, total } = await response.json();
import requests
response = requests.get(
'https://api.usegately.com/api/v1/email/logs',
headers={'Authorization': 'Bearer gately_YOUR_API_KEY'},
params={'type': 'transactional', 'limit': 10},
)
print(response.json())
{
"logs": [
{
"id": "a1b2c3d4-e5f6-...",
"to_email": "user@example.com",
"from_email": "hello@yourdomain.com",
"subject": "Welcome to Acme!",
"email_type": "transactional",
"status": "sent",
"message_id": "0100019fc2ed413a-69325b2f-...",
"open_count": 2,
"click_count": 1,
"sent_at": "2026-08-02T10:30:00Z",
"opened_at": "2026-08-02T10:35:00Z",
"tags": { "type": "welcome" }
}
],
"total": 42,
"limit": 10,
"offset": 0
}
{
"error": "Invalid or missing API key"
}
Was this page helpful?
⌘I