Skip to main content
GET
/
api
/
enrich
/
{jobId}
/
leads
Get Leads
curl --request GET \
  --url https://api.example.com/api/enrich/{jobId}/leads
{
  "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>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://withcheetah.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Path Parameters

​
jobId
string
required
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

curl https://api.cheetah-sales.dev/api/enrich/run_cm5x8k9j0000108l4g2h5h3k2/leads \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

​
success
boolean
Whether the request was successful
​
totalLeads
number
Total number of leads
​
leads
array
Array of enriched lead objects
Response
{
  "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": "jane.doe@techcorp.com",
      "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": "john@startupxyz.com",
      "phone": null,
      "address": "456 Startup Ave, New York, NY 10001",
      "enrichmentStatus": "enriched"
    }
  ]
}

​
Data Coverage

Data PointCoverage
Email70-85%
Phone40-60%
Address80-90%
Leads with failed enrichmentStatus will still have basic info (name, title, company, LinkedIn URL) but may be missing email/phone.