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

Each item is a test plus its latestReport (once a run has finished) and its currentRun (while one is in flight). Page through the list with nextCursor.

Query Parameters

string
required
Your SmartLead API key
number
Only tests in this folder
string
MANUAL or AUTO
string
ACTIVE, PAUSED, COMPLETED or STOPPED
number
Page size, 1 to 100. Default 20
string
nextCursor from the previous page

Response Fields

array
number
Number of matching tests. Only on the first page (no cursor)
string | null
Pass as cursor for the next page. null on the last page

Response Codes

Success
Success
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)