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

Use it to follow a run while it sends and while results come in. Once status is COMPLETED the report is ready: see Get Run Report.

Path Parameters

string
required
Run ID (UUID)

Query Parameters

string
required
Your SmartLead API key

Response Fields

string
Run ID (UUID)
number
Run number within the test, starting at 1
string
QUEUED, SENDING, COLLECTING, COMPLETED, FAILED, SKIPPED or CANCELLED
string | null
Why a run failed, was skipped or cancelled
string
When the run was due to start
object | null
The email content that was sent (subject, body and the lead used for merge tags)
array | null
Senders left out of the run, with the reason
boolean
true when some emails went to a different seed than first planned
string | null
When the run completed
string
Creation time
boolean
true when the test is paused and this run’s unsent emails are waiting
object | null
id, name, type and status of the test the run belongs to
array
One item per email

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)