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

One item per test email, in ID order. Filter by provider, sender or placement and page with nextCursor.

Path Parameters

string
required
Run ID (UUID)

Query Parameters

string
required
Your SmartLead API key
string
Provider code, for example GOOGLE_WORKSPACE
number
Smartlead email account ID of the sender
string
INBOX, TAB, SPAM, MISSING, UNREADABLE, NOT_SENT, UNCONFIRMED, PENDING or BOUNCED
number
Page size, 1 to 200. Default 50
string
nextCursor from the previous page

Response Fields

array
string | null
Pass as cursor for the next page. null on the last page

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)