curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/report?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/report",
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/report?api_key=${API_KEY}`,
{
method: 'GET'
}
);
console.log(await response.json());
{
"ready": true,
"runId": "8a1c7e90-2b3d-4c5e-8f60-7a9b0c1d2e3f",
"completedAt": "2026-11-17T09:21:00.000Z",
"score": 72,
"band": "fair",
"counts": {
"expected": 24, "sent": 24, "failed": 0,
"inbox": 18, "tab": 2, "spam": 3, "missing": 1,
"unreadable": 0, "notSent": 0, "unconfirmed": 0,
"bouncedSeed": 0, "bouncedSender": 0, "bouncedUnknown": 0,
"spfFail": 0, "dkimFail": 0, "dmarcFail": 0,
"inboxRate": 0.75
},
"timeToInbox": { "medianMs": 41000, "p90Ms": 118000 },
"byProvider": [ { "provider": "GOOGLE_WORKSPACE", "counts": { "inbox": 9, "spam": 1, "inboxRate": 0.9 } } ],
"diagnostics": { "blacklists": [], "dns": [], "content": null, "spamAssassin": null, "senders": [] }
}
(shortened: parts, headline, baseline, insights, bySender and matrix omitted)
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API Key"
}
}
Smart Delivery v2 (Deliverability Test)
Get Run Report
The stored deliverability report of a completed run
GET
/
api
/
v1
/
smart-delivery
/
runs
/
{id}
/
report
curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/report?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/report",
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/report?api_key=${API_KEY}`,
{
method: 'GET'
}
);
console.log(await response.json());
{
"ready": true,
"runId": "8a1c7e90-2b3d-4c5e-8f60-7a9b0c1d2e3f",
"completedAt": "2026-11-17T09:21:00.000Z",
"score": 72,
"band": "fair",
"counts": {
"expected": 24, "sent": 24, "failed": 0,
"inbox": 18, "tab": 2, "spam": 3, "missing": 1,
"unreadable": 0, "notSent": 0, "unconfirmed": 0,
"bouncedSeed": 0, "bouncedSender": 0, "bouncedUnknown": 0,
"spfFail": 0, "dkimFail": 0, "dmarcFail": 0,
"inboxRate": 0.75
},
"timeToInbox": { "medianMs": 41000, "p90Ms": 118000 },
"byProvider": [ { "provider": "GOOGLE_WORKSPACE", "counts": { "inbox": 9, "spam": 1, "inboxRate": 0.9 } } ],
"diagnostics": { "blacklists": [], "dns": [], "content": null, "spamAssassin": null, "senders": [] }
}
(shortened: parts, headline, baseline, insights, bySender and matrix 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
Returns the score, placement counts, breakdowns and diagnostics (blocklists, DNS, content, SpamAssassin, sender mailboxes) of a completed run. Until the report is built the response is{ "ready": false, "status": "..." }: poll Get Run Placement or this endpoint until ready is true.
Path Parameters
Query Parameters
curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/report?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/report",
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/report?api_key=${API_KEY}`,
{
method: 'GET'
}
);
console.log(await response.json());
Response Fields
The score’s parts (
placement, auth, content, reputation, hygiene) with weight and value (0 to 1, null when not available for this run)Counts for the emails sent:
expected, sent, failed, inbox, tab, spam, missing, unreadable, notSent, unconfirmed, bouncedSeed, bouncedSender, bouncedUnknown, spfFail, dkimFail, dmarcFail, and inboxRate (inbox share of the emails that reached a verdict, 0 to 1, or null when none did). Seed-side bounces (bouncedSeed) are left out of the placement rate; sender-side and unknown bounces count as not delivered.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){
"ready": true,
"runId": "8a1c7e90-2b3d-4c5e-8f60-7a9b0c1d2e3f",
"completedAt": "2026-11-17T09:21:00.000Z",
"score": 72,
"band": "fair",
"counts": {
"expected": 24, "sent": 24, "failed": 0,
"inbox": 18, "tab": 2, "spam": 3, "missing": 1,
"unreadable": 0, "notSent": 0, "unconfirmed": 0,
"bouncedSeed": 0, "bouncedSender": 0, "bouncedUnknown": 0,
"spfFail": 0, "dkimFail": 0, "dmarcFail": 0,
"inboxRate": 0.75
},
"timeToInbox": { "medianMs": 41000, "p90Ms": 118000 },
"byProvider": [ { "provider": "GOOGLE_WORKSPACE", "counts": { "inbox": 9, "spam": 1, "inboxRate": 0.9 } } ],
"diagnostics": { "blacklists": [], "dns": [], "content": null, "spamAssassin": null, "senders": [] }
}
(shortened: parts, headline, baseline, insights, bySender and matrix omitted)
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API Key"
}
}
