Get Leads
Copy
curl --request GET \
--url https://api.example.com/api/enrich/{jobId}/leadsCopy
{
"success": true,
"totalLeads": 123,
"leads": [
{
"leads[].id": "<string>",
"leads[].name": "<string>",
"leads[].title": "<string>",
"leads[].company": "<string>",
"leads[].location": "<string>",
"leads[].linkedinUrl": "<string>",
"leads[].email": "<string>",
"leads[].phone": "<string>",
"leads[].address": "<string>",
"leads[].enrichmentStatus": "<string>"
}
]
}Endpoints
Get Leads
Retrieve all enriched leads from a completed enrich job
GET
/
api
/
enrich
/
{jobId}
/
leads
Get Leads
Copy
curl --request GET \
--url https://api.example.com/api/enrich/{jobId}/leadsCopy
{
"success": true,
"totalLeads": 123,
"leads": [
{
"leads[].id": "<string>",
"leads[].name": "<string>",
"leads[].title": "<string>",
"leads[].company": "<string>",
"leads[].location": "<string>",
"leads[].linkedinUrl": "<string>",
"leads[].email": "<string>",
"leads[].phone": "<string>",
"leads[].address": "<string>",
"leads[].enrichmentStatus": "<string>"
}
]
}Path Parameters
The job ID from
POST /api/enrich. Starts with run_This endpoint only works for jobs with status
COMPLETED. If the job is still running, you’ll receive an error.Request
Copy
curl https://api.cheetah-sales.dev/api/enrich/run_cm5x8k9j0000108l4g2h5h3k2/leads \
-H "Authorization: Bearer YOUR_API_KEY"
Response
Whether the request was successful
Total number of leads
Array of enriched lead objects
Show lead properties
Show lead properties
Unique lead ID
Full name
Job title
Company name
Geographic location
LinkedIn profile URL
Work email (70-85% coverage)
Phone number (40-60% coverage)
Company address
Status:
enriched, pending, or failedResponse
Copy
{
"success": true,
"jobId": "run_cm5x8k9j0000108l4g2h5h3k2",
"listId": "550e8400-e29b-41d4-a716-446655440000",
"totalLeads": 25,
"leads": [
{
"id": "lead-uuid-1",
"name": "Jane Doe",
"title": "VP of Engineering",
"company": "TechCorp",
"location": "San Francisco Bay Area",
"linkedinUrl": "https://www.linkedin.com/in/janedoe",
"email": "[email protected]",
"phone": "+1-555-123-4567",
"address": "123 Tech Street, San Francisco, CA 94105",
"enrichmentStatus": "enriched"
},
{
"id": "lead-uuid-2",
"name": "John Smith",
"title": "Director of Engineering",
"company": "StartupXYZ",
"location": "New York City",
"linkedinUrl": "https://www.linkedin.com/in/johnsmith",
"email": "[email protected]",
"phone": null,
"address": "456 Startup Ave, New York, NY 10001",
"enrichmentStatus": "enriched"
}
]
}
Data Coverage
| Data Point | Coverage |
|---|---|
| 70-85% | |
| Phone | 40-60% |
| Address | 80-90% |
Leads with
failed enrichmentStatus will still have basic info (name, title, company, LinkedIn URL) but may be missing email/phone.⌘I