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 completed run, oldest first. Without from and to it covers the last 30 days (UTC); the range is at most 400 days. A page holds the newest runs (up to 100), listed oldest first; use nextCursor to get the runs before them.

Path Parameters

string
required
Test ID (UUID)

Query Parameters

string
required
Your SmartLead API key
string
First day, YYYY-MM-DD (UTC)
string
Last day, YYYY-MM-DD (UTC)
number
Page size, 1 to 100. Default 100
string
nextCursor from the previous page

Response Fields

string
First day of the range
string
Last day of the range
array
string | null
Pass as cursor to get the runs before this page. null when there are no more

Response Codes

Success
Success
Error
Invalid date range (RANGE_INVALID)
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)