{ "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.
Query Parameters
string
required
Your SmartLead API key
string
First day, YYYY-MM-DD (UTC). Default: 29 days before to
string
Last day, YYYY-MM-DD (UTC). Default: today. The range is at most 400 days
number
Only this provider
number
Page size, 1 to 100. Default 50
string
nextCursor from the previous page
curl -X GET "https://sl-sd-api.smartlead.ai/api/v1/smart-delivery/reports/mailboxes?api_key=YOUR_KEY"
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.
number | null
Average send-to-inbox time
string | null
Pass as cursor for the next page. null on the last page
Response Codes
Success
Success
Error
Invalid date range (RANGE_INVALID)
Unauthorized
Missing, invalid or expired API key (UNAUTHORIZED)
Forbidden
Client (agency) API keys are not allowed (CLIENT_NOT_ALLOWED), or your plan does not include API access (API_ACCESS_RESTRICTED)
Too Many Requests
Too many requests for this API key. Wait the number of seconds in the Retry-After header (RATE_LIMITED)