curl -X POST "https://prospect-api.smartlead.ai/api/v1/search-email-leads/get-contacts?api_key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"filter_id": 327105, "limit": 50, "offset": 0}'
{
"success": true,
"message": "Data retrieved successfully",
"data": {
"list": [
{
"id": "5f22b0c8cff47e0001616f81",
"firstName": "Orhan",
"lastName": "Demiri",
"fullName": "Orhan Demiri",
"title": "Director",
"company": { "name": "Example Corp", "website": "example.com" },
"email": "orhan@example.com",
"verificationStatus": "valid",
"status": "completed"
}
],
"pagination": {
"filterId": 327105,
"limit": 50,
"offset": 0,
"total": 100,
"hasMore": true
},
"totalCount": 100
}
}
{
"statusCode": 401,
"success": false,
"message": "Unauthorized",
"error": "User not authenticated"
}
Smart Prospect
Get Contacts API
Retrieve saved contacts by filter or by adapt IDs - POST /get-contacts
POST
/
api
/
v1
/
search-email-leads
/
get-contacts
curl -X POST "https://prospect-api.smartlead.ai/api/v1/search-email-leads/get-contacts?api_key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"filter_id": 327105, "limit": 50, "offset": 0}'
{
"success": true,
"message": "Data retrieved successfully",
"data": {
"list": [
{
"id": "5f22b0c8cff47e0001616f81",
"firstName": "Orhan",
"lastName": "Demiri",
"fullName": "Orhan Demiri",
"title": "Director",
"company": { "name": "Example Corp", "website": "example.com" },
"email": "orhan@example.com",
"verificationStatus": "valid",
"status": "completed"
}
],
"pagination": {
"filterId": 327105,
"limit": 50,
"offset": 0,
"total": 100,
"hasMore": true
},
"totalCount": 100
}
}
{
"statusCode": 401,
"success": false,
"message": "Unauthorized",
"error": "User not authenticated"
}
This endpoint requires authentication via API key passed as a query parameter (
api_key).Query Parameters
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.string[]
Array of adapt_ids (max 200). Required when not using filter_id.
number
Filter ID to get data for. Required when not using id.
number
Number of records to return (1–1000, optional when using filter_id).
number
Number of records to skip (≥ 0, optional when using filter_id).
string
Search string to filter by first_name, last_name, or full_name.
string
Filter by email verification status: valid, catch_all, or invalid.
string
Filter by catch-all status: catch_all_verified, catch_all_soft_bounced, catch_all_hard_bounced, catch_all_unknown, catch_all_bounced.
curl -X POST "https://prospect-api.smartlead.ai/api/v1/search-email-leads/get-contacts?api_key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"filter_id": 327105, "limit": 50, "offset": 0}'
Response Codes
Success
Request successful
Bad Request
Bad Request
Unauthorized
Unauthorized
Internal Server Error
Internal Server Error
{
"success": true,
"message": "Data retrieved successfully",
"data": {
"list": [
{
"id": "5f22b0c8cff47e0001616f81",
"firstName": "Orhan",
"lastName": "Demiri",
"fullName": "Orhan Demiri",
"title": "Director",
"company": { "name": "Example Corp", "website": "example.com" },
"email": "orhan@example.com",
"verificationStatus": "valid",
"status": "completed"
}
],
"pagination": {
"filterId": 327105,
"limit": 50,
"offset": 0,
"total": 100,
"hasMore": true
},
"totalCount": 100
}
}
{
"statusCode": 401,
"success": false,
"message": "Unauthorized",
"error": "User not authenticated"
}