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

A light call to poll while a run is sending or collecting. For the full scored report use Get Run Report.

Path Parameters

string
required
Run ID (UUID)

Query Parameters

string
required
Your SmartLead API key

Response Fields

string
Run ID
string
Run status
boolean
true when the test is paused and unsent emails are waiting
string | null
End of the window in which results are collected
string | null
When the final results are expected
string | null
Planned time of the next email still to go out
string | null
Planned time of the last email
number
Emails sent so far
number
Emails still to be sent
object
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)
array
Same counts per provider
array
Same counts per senderEmail
array
Same counts per provider and senderEmail

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)