curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/emails/90211/trace?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/emails/90211/trace",
params={"api_key": API_KEY}
)
print(response.status_code)
print(response.json())
const API_KEY = 'YOUR_API_KEY';
const response = await fetch(
`https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/emails/90211/trace?api_key=${API_KEY}`,
{
method: 'GET'
}
);
console.log(await response.json());
{
"email": {
"id": 90211,
"senderEmail": "alex@sender-one.com",
"provider": "GOOGLE_WORKSPACE",
"sendStatus": "SENT",
"placement": "INBOX",
"sentAt": "2026-11-17T08:31:14.000Z",
"foundAt": "2026-11-17T08:31:50.000Z",
"checksCount": 2,
"minutesAfterSend": 1
},
"events": [
{ "at": "2026-11-17T08:31:14.000Z", "type": "SENT", "detail": null }
]
}
(some fields omitted)
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API Key"
}
}
Smart Delivery v2 (Deliverability Test)
Get Email Trace
The step-by-step history of one test email
GET
/
api
/
v1
/
smart-delivery
/
runs
/
{id}
/
emails
/
{assignmentId}
/
trace
curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/emails/90211/trace?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/emails/90211/trace",
params={"api_key": API_KEY}
)
print(response.status_code)
print(response.json())
const API_KEY = 'YOUR_API_KEY';
const response = await fetch(
`https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/emails/90211/trace?api_key=${API_KEY}`,
{
method: 'GET'
}
);
console.log(await response.json());
{
"email": {
"id": 90211,
"senderEmail": "alex@sender-one.com",
"provider": "GOOGLE_WORKSPACE",
"sendStatus": "SENT",
"placement": "INBOX",
"sentAt": "2026-11-17T08:31:14.000Z",
"foundAt": "2026-11-17T08:31:50.000Z",
"checksCount": 2,
"minutesAfterSend": 1
},
"events": [
{ "at": "2026-11-17T08:31:14.000Z", "type": "SENT", "detail": null }
]
}
(some fields omitted)
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API Key"
}
}
Smart Delivery v2 (Deliverability Test) API: the deliverability (inbox placement) test that sends your campaign email to seed inboxes and reports where it landed. Contact support@smartlead.ai for access.
Overview
Shows what happened to a single email: when it was sent, how often it was looked for and why it got its placement. The seed address is never returned.Path Parameters
Email ID from Get Run (
assignments[].id)Query Parameters
curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/emails/90211/trace?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/emails/90211/trace",
params={"api_key": API_KEY}
)
print(response.status_code)
print(response.json())
const API_KEY = 'YOUR_API_KEY';
const response = await fetch(
`https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/emails/90211/trace?api_key=${API_KEY}`,
{
method: 'GET'
}
);
console.log(await response.json());
Response Fields
Show email
Show email
Response Codes
Client (agency) API keys are not allowed (
CLIENT_NOT_ALLOWED), or your plan does not include API access (API_ACCESS_RESTRICTED)Too many requests for this API key. Wait the number of seconds in the
Retry-After header (RATE_LIMITED){
"email": {
"id": 90211,
"senderEmail": "alex@sender-one.com",
"provider": "GOOGLE_WORKSPACE",
"sendStatus": "SENT",
"placement": "INBOX",
"sentAt": "2026-11-17T08:31:14.000Z",
"foundAt": "2026-11-17T08:31:50.000Z",
"checksCount": 2,
"minutesAfterSend": 1
},
"events": [
{ "at": "2026-11-17T08:31:14.000Z", "type": "SENT", "detail": null }
]
}
(some fields omitted)
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API Key"
}
}
