curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/tests/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/tests/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b",
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/tests/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b?api_key=${API_KEY}`,
{
method: 'GET'
}
);
console.log(await response.json());
{
"id": "3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b",
"name": "Q4 Outbound - sequence step 1",
"type": "MANUAL",
"status": "ACTIVE",
"providers": ["GOOGLE_WORKSPACE", "MICROSOFT_365"],
"senders": [
{ "id": 501, "emailAccountId": 88101, "email": "alex@sender-one.com", "senderType": "SMTP" }
],
"runs": [
{
"id": "8a1c7e90-2b3d-4c5e-8f60-7a9b0c1d2e3f",
"runNo": 1,
"status": "SENDING",
"progress": { "sent": 9, "unsent": 15, "total": 24, "held": false, "resultsExpectedAt": "2026-11-17T09:20:00.000Z" }
}
]
}
(other test and run fields omitted)
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API Key"
}
}
Smart Delivery v2 (Deliverability Test)
Get Deliverability Test
Get one deliverability test with its senders, providers and runs
GET
/
api
/
v1
/
smart-delivery
/
tests
/
{id}
curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/tests/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/tests/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b",
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/tests/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b?api_key=${API_KEY}`,
{
method: 'GET'
}
);
console.log(await response.json());
{
"id": "3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b",
"name": "Q4 Outbound - sequence step 1",
"type": "MANUAL",
"status": "ACTIVE",
"providers": ["GOOGLE_WORKSPACE", "MICROSOFT_365"],
"senders": [
{ "id": 501, "emailAccountId": 88101, "email": "alex@sender-one.com", "senderType": "SMTP" }
],
"runs": [
{
"id": "8a1c7e90-2b3d-4c5e-8f60-7a9b0c1d2e3f",
"runNo": 1,
"status": "SENDING",
"progress": { "sent": 9, "unsent": 15, "total": 24, "held": false, "resultsExpectedAt": "2026-11-17T09:20:00.000Z" }
}
]
}
(other test and run 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
Returns the test, its provider codes and sender mailboxes, and its latest 50 runs. A run in flight carries aprogress block.
Path Parameters
Query Parameters
curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/tests/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/tests/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b",
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/tests/3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b?api_key=${API_KEY}`,
{
method: 'GET'
}
);
console.log(await response.json());
Response Fields
Why the test is in this status, for example
USER_PAUSED, USER_STOPPED or SCHEDULE_ENDEDThe test’s runs, newest first (up to 50). Same fields as Get Run without the emails, plus
progress (sent, unsent, total, held, resultsExpectedAt) while the run is in flight, otherwise 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){
"id": "3f2b8c1e-5d4a-4e7b-9a60-1c2d3e4f5a6b",
"name": "Q4 Outbound - sequence step 1",
"type": "MANUAL",
"status": "ACTIVE",
"providers": ["GOOGLE_WORKSPACE", "MICROSOFT_365"],
"senders": [
{ "id": 501, "emailAccountId": 88101, "email": "alex@sender-one.com", "senderType": "SMTP" }
],
"runs": [
{
"id": "8a1c7e90-2b3d-4c5e-8f60-7a9b0c1d2e3f",
"runNo": 1,
"status": "SENDING",
"progress": { "sent": 9, "unsent": 15, "total": 24, "held": false, "resultsExpectedAt": "2026-11-17T09:20:00.000Z" }
}
]
}
(other test and run fields omitted)
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API Key"
}
}
