Get Leads

Retrieve all enriched leads from a completed enrich job

GET /api/enrich/{jobId}/leads

Get Leads

cURL

curl --request GET \
  --url https://api.example.com/api/enrich/{jobId}/leads

200

{
  "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

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

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

Show lead properties

leads[].id · string

Unique lead ID

leads[].name · string

Full name

leads[].title · string

Job title

leads[].company · string

Company name

leads[].location · string

Geographic location

leads[].linkedinUrl · string

LinkedIn profile URL

leads[].email · string

Work email (70-85% coverage)

leads[].phone · string

Phone number (40-60% coverage)

leads[].address · string

Company address

leads[].enrichmentStatus · string

Status: enriched, pending, or failed

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": "[e-mail]",
      "phone": "[phone]",
      "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": "[e-mail]",
      "phone": null,
      "address": "456 Startup Ave, New York, NY 10001",
      "enrichmentStatus": "enriched"
    }
  ]
}

Data Coverage

Data Point	Coverage
Email	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.