/api/v1/leadsList & Search Enriched Leads
Fetches a paginated, filterable collection of enriched B2B leads associated with your workspace API key.
Execution behavior: Returns an array of normalized lead objects sorted newest first, isolated to your authenticated workspace account.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | number | Optional | Page number for pagination (default: 1). |
| limit | number | Optional | Records per page (default: 100). |
| source | string | Optional | Filter by origin pipeline (e.g., 'google_maps', 'yellow_pages'). |
| verified | boolean | Optional | Set to true to return only SMTP-verified email rows. |
| minConfidence | number | Optional | Filter leads with confidence score >= threshold (e.g., 80). |
{
"success": true,
"leads": [
{
"_id": "66c3a1b8e4b0123456789abc",
"name": "Marco Rodriguez",
"email": "m.rodriguez@apexroofingmia.com",
"company": "Apex Commercial Roofing",
"phone": "+13055550192",
"website": "https://apexroofingmia.com",
"confidence": 96,
"verified": true,
"source": "google_maps"
}
],
"pagination": { "page": 1, "limit": 100, "total": 450, "pages": 5 }
}