Skip to main content
POST
/
api
/
v1
/
search-email-leads
/
fetch-contacts
curl -X POST "https://prospect-api.smartlead.ai/api/v1/search-email-leads/fetch-contacts?api_key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filter_id": 327105, "limit": 10, "visual_limit": 10, "visual_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",
        "status": "completed"
      }
    ],
    "total_count": 1,
    "visual_limit": 10,
    "visual_offset": 0,
    "metrics": {
      "totalContacts": 1,
      "totalEmails": 1,
      "noEmailFound": 0,
      "invalidEmails": 0,
      "catchAllEmails": 0,
      "verifiedEmails": 1,
      "completed": 1
    }
  }
}
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. filter_id is required. You must provide either id (array of adapt IDs) with filter_id, or limit with filter_id. When using limit, it must be between 1 and 10000 (or 30000 for some users). Limit and credit checks apply when using limit; failures return 200 with success: false and an error message.
​
filter_id
number
required
Filter ID (positive number).
​
id
string[]
Adapt IDs to fetch (use with filter_id; no limit check). Required when not using limit.
​
limit
number
Number of contacts to fetch for the filter (1–10000 or 1–30000 for some users). Required when not using id.
​
visual_limit
number
Page size for visual pagination (1–1000, default 10).
​
visual_offset
number
Offset for visual pagination (≥ 0, default 0).
curl -X POST "https://prospect-api.smartlead.ai/api/v1/search-email-leads/fetch-contacts?api_key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filter_id": 327105, "limit": 10, "visual_limit": 10, "visual_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",
        "status": "completed"
      }
    ],
    "total_count": 1,
    "visual_limit": 10,
    "visual_offset": 0,
    "metrics": {
      "totalContacts": 1,
      "totalEmails": 1,
      "noEmailFound": 0,
      "invalidEmails": 0,
      "catchAllEmails": 0,
      "verifiedEmails": 1,
      "completed": 1
    }
  }
}