Skip to main content
GET
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

string
required
Run ID (UUID)

Query Parameters

string
required
Your SmartLead API key

Response Fields

boolean
false while the report is not built yet. Then only status follows
string
Run ID
string
When the run completed
number | null
Deliverability score, 0 to 100
string | null
poor (below 40), fair (40 to 79) or good (80 and above)
array
The score’s parts (placement, auth, content, reputation, hygiene) with weight and value (0 to 1, null when not available for this run)
object
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.
object
medianMs and p90Ms: time from send to inbox
object | null
One-line summary of the result
object | null
How the score compares with other Smart Delivery tests
object | null
The issues found and how to fix them, and the checks that passed
boolean
true when a copy of some received emails could not be stored, so some details are missing
boolean
true when some emails went to a different seed than first planned
array
provider and counts per provider
array
emailAccountId, senderEmail, sendingDomain and counts per sender
array
provider, emailAccountId and counts for every provider and sender pair
object
blacklists, dns, content, spamAssassin and senders checks

Response Codes

Success
Success
Error
Run not found (RUN_NOT_FOUND)
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)