API Reference

Get contacts

post
https://prospect-api.smartlead.ai/api/v1/search-email-leads/get-contacts

Retrieve saved contacts either by filter_id (with optional limit/offset/search/verification filters) or by id (array of adapt_ids, max 200). Requires authentication via Bearer token or API key in query (?api_key=...). Provide either id or filter_id — not both (XOR).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

API key for authentication (when calling /api/v1/get-contacts). Without it, the request returns 401 Unauthorized.

Body Params

Provide either id (array of adapt_ids, max 200) or filter_id (number). Do not provide both. When using filter_id, you may optionally include limit, offset, search, verification_status, catch_all_status.

id
array of strings
required
length ≤ 200

Array of adapt_ids (max 200). Use when fetching specific contacts.

id*
number

Filter ID to get data for. Use when fetching by filter with optional limit/offset.

number
1 to 1000

Number of records to return (optional, when using filter_id).

number
≥ 0

Number of records to skip (optional, when using filter_id).

string

Search string to filter by first_name, last_name, or full_name (optional).

string
enum

Filter by email verification status (optional).

Allowed:
string
enum

Filter by catch-all status (optional).

Allowed:
Responses

Updated 3 months ago

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago