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 test, its provider codes and sender mailboxes, and its latest 50 runs. A run in flight carries a progress block.

Path Parameters

string
required
Test ID (UUID)

Query Parameters

string
required
Your SmartLead API key

Response Fields

string
Test ID (UUID). Use it in every /tests/{id} path.
string
Test name
string | null
Test description
string
MANUAL (one run, started now) or AUTO (recurring runs on a schedule)
string
ACTIVE, PAUSED, COMPLETED or STOPPED
string | null
Why the test is in this status, for example USER_PAUSED, USER_STOPPED or SCHEDULE_ENDED
number | null
Folder the test is in
number
Smartlead campaign whose email is tested
number
Sequence step that is tested
number | null
A/B variant tested, or null for the step’s base email
number
Seed inboxes each sender mails per provider
boolean
true when all emails of a run go out together, false when they are spread by sendGapMinutes
number | null
Minutes between emails when they are spread out
boolean
Whether the emails are sent as text only (no HTML)
object | null
AUTO tests: the schedule (see Create Deliverability Test)
string | null
AUTO tests: first run time (ISO 8601)
string | null
AUTO tests: the date after which no run starts
number | null
AUTO tests: the number of runs after which the test completes
string | null
AUTO tests: when the next run starts
number
Runs created so far
string
Creation time (ISO 8601)
string[]
Provider codes the test sends to
array
array
The test’s runs, newest first (up to 50). Same fields as Get Run without the emails, plus progress (sent, unsent, total, held, resultsExpectedAt) while the run is in flight, otherwise null.

Response Codes

Success
Success
Error
Test not found (TEST_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)