curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/reports/summary?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/reports/summary",
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/reports/summary?api_key=${API_KEY}`,
{
method: 'GET'
}
);
console.log(await response.json());
{
"from": "2026-10-19",
"to": "2026-11-17",
"runs": 10,
"counts": { "sent": 240, "inbox": 180, "spam": 30, "inboxRate": 0.75 },
"avgTimeToInboxMs": 44000
}
(counts abbreviated)
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API Key"
}
}
Smart Delivery v2 (Deliverability Test)
Get Deliverability Summary
Totals across all your mailboxes over a date range
GET
/
api
/
v1
/
smart-delivery
/
reports
/
summary
curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/reports/summary?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/reports/summary",
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/reports/summary?api_key=${API_KEY}`,
{
method: 'GET'
}
);
console.log(await response.json());
{
"from": "2026-10-19",
"to": "2026-11-17",
"runs": 10,
"counts": { "sent": 240, "inbox": 180, "spam": 30, "inboxRate": 0.75 },
"avgTimeToInboxMs": 44000
}
(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
Adds up every completed run in the range, across all tests.Query Parameters
curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/reports/summary?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/reports/summary",
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/reports/summary?api_key=${API_KEY}`,
{
method: 'GET'
}
);
console.log(await response.json());
Response Fields
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){
"from": "2026-10-19",
"to": "2026-11-17",
"runs": 10,
"counts": { "sent": 240, "inbox": 180, "spam": 30, "inboxRate": 0.75 },
"avgTimeToInboxMs": 44000
}
(counts abbreviated)
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API Key"
}
}
