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

Adds up every completed run in the range, across all tests.

Query Parameters

string
required
Your SmartLead API key
string
First day, YYYY-MM-DD (UTC). Default: 29 days before to
string
Last day, YYYY-MM-DD (UTC). Default: today. The range is at most 400 days

Response Fields

string
First day
string
Last day
number
Completed runs in the range
object
Counts for the emails sent: expected, sent, failed, inbox, tab, spam, missing, unreadable, notSent, unconfirmed, bouncedSeed, bouncedSender, bouncedUnknown, spfFail, dkimFail, dmarcFail, and inboxRate (inbox share of the emails that reached a verdict, 0 to 1, or null when none did). Seed-side bounces (bouncedSeed) are left out of the placement rate; sender-side and unknown bounces count as not delivered.
number | null
Average send-to-inbox time

Response Codes

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