curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/placement?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/placement",
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/placement?api_key=${API_KEY}`,
{
method: 'GET'
}
);
console.log(await response.json());
{
"runId": "8a1c7e90-2b3d-4c5e-8f60-7a9b0c1d2e3f",
"status": "COLLECTING",
"held": false,
"collectingUntil": "2026-11-17T09:20:00.000Z",
"resultsExpectedAt": "2026-11-17T09:20:00.000Z",
"nextSendAt": null,
"lastSendAt": "2026-11-17T08:50:00.000Z",
"sent": 8,
"unsent": 0,
"totals": { "inbox": 6, "tab": 1, "spam": 1, "missing": 0, "unreadable": 0, "unconfirmed": 0, "notSent": 0, "pending": 0, "bounced": 0, "total": 8, "measured": 8,
"percent": { "inbox": 75, "tab": 12.5, "spam": 12.5, "missing": 0 } },
"byProvider": [ { "provider": "GOOGLE_WORKSPACE", "inbox": 3, "total": 4 } ],
"bySender": [ { "senderEmail": "alex@sender-one.com", "inbox": 6, "total": 8 } ],
"byProviderAndSender": [ { "provider": "GOOGLE_WORKSPACE", "senderEmail": "alex@sender-one.com", "inbox": 3, "total": 4 } ]
}
(per-group counts abbreviated)
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API Key"
}
}
Smart Delivery v2 (Deliverability Test)
Get Run Placement
Live placement summary of a run, by provider and sender
GET
/
api
/
v1
/
smart-delivery
/
runs
/
{id}
/
placement
curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/placement?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/placement",
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/placement?api_key=${API_KEY}`,
{
method: 'GET'
}
);
console.log(await response.json());
{
"runId": "8a1c7e90-2b3d-4c5e-8f60-7a9b0c1d2e3f",
"status": "COLLECTING",
"held": false,
"collectingUntil": "2026-11-17T09:20:00.000Z",
"resultsExpectedAt": "2026-11-17T09:20:00.000Z",
"nextSendAt": null,
"lastSendAt": "2026-11-17T08:50:00.000Z",
"sent": 8,
"unsent": 0,
"totals": { "inbox": 6, "tab": 1, "spam": 1, "missing": 0, "unreadable": 0, "unconfirmed": 0, "notSent": 0, "pending": 0, "bounced": 0, "total": 8, "measured": 8,
"percent": { "inbox": 75, "tab": 12.5, "spam": 12.5, "missing": 0 } },
"byProvider": [ { "provider": "GOOGLE_WORKSPACE", "inbox": 3, "total": 4 } ],
"bySender": [ { "senderEmail": "alex@sender-one.com", "inbox": 6, "total": 8 } ],
"byProviderAndSender": [ { "provider": "GOOGLE_WORKSPACE", "senderEmail": "alex@sender-one.com", "inbox": 3, "total": 4 } ]
}
(per-group counts abbreviated)
{
"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
A light call to poll while a run is sending or collecting. For the full scored report use Get Run Report.Path Parameters
Query Parameters
curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/runs/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b/placement?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/placement",
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/placement?api_key=${API_KEY}`,
{
method: 'GET'
}
);
console.log(await response.json());
Response Fields
Placement counts for the whole run:
inbox, tab, spam, missing, unreadable, unconfirmed, notSent, pending, bounced, total, measured and percent (inbox, tab, spam, missing as a share of measured, or null)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){
"runId": "8a1c7e90-2b3d-4c5e-8f60-7a9b0c1d2e3f",
"status": "COLLECTING",
"held": false,
"collectingUntil": "2026-11-17T09:20:00.000Z",
"resultsExpectedAt": "2026-11-17T09:20:00.000Z",
"nextSendAt": null,
"lastSendAt": "2026-11-17T08:50:00.000Z",
"sent": 8,
"unsent": 0,
"totals": { "inbox": 6, "tab": 1, "spam": 1, "missing": 0, "unreadable": 0, "unconfirmed": 0, "notSent": 0, "pending": 0, "bounced": 0, "total": 8, "measured": 8,
"percent": { "inbox": 75, "tab": 12.5, "spam": 12.5, "missing": 0 } },
"byProvider": [ { "provider": "GOOGLE_WORKSPACE", "inbox": 3, "total": 4 } ],
"bySender": [ { "senderEmail": "alex@sender-one.com", "inbox": 6, "total": 8 } ],
"byProviderAndSender": [ { "provider": "GOOGLE_WORKSPACE", "senderEmail": "alex@sender-one.com", "inbox": 3, "total": 4 } ]
}
(per-group counts abbreviated)
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API Key"
}
}
