Skip to main content
POST
This endpoint requires authentication via API key passed as a query parameter (api_key).

Query Parameters

api_key
string
required
Your SmartLead API key for authentication

Request Body

The request body must be JSON. Provide either id (array of adapt_ids, max 200) or filter_id (number). Do not provide both (XOR). When using filter_id, you may optionally include limit, offset, search, verification_status, and catch_all_status.
id
string[]
Array of adapt_ids (max 200). Required when not using filter_id.
filter_id
number
Filter ID to get data for. Required when not using id.
limit
number
Number of records to return (1–1000, optional when using filter_id).
offset
number
Number of records to skip (≥ 0, optional when using filter_id).
Search string to filter by first_name, last_name, or full_name.
verification_status
string
Filter by email verification status: valid, catch_all, or invalid.
catch_all_status
string
Filter by catch-all status: catch_all_verified, catch_all_soft_bounced, catch_all_hard_bounced, catch_all_unknown, catch_all_bounced.

Response Codes

200
Success
Request successful
400
Bad Request
Bad Request
401
Unauthorized
Unauthorized
500
Internal Server Error
Internal Server Error