Skip to main content
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
  }
}
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
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.
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

​
200
Success
Request successful
​
400
Bad Request
Bad Request
​
401
Unauthorized
Unauthorized
​
500
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
  }
}