Get Job Status

Check the status of a running or completed enrich job

GET /api/enrich/{jobId}

Get Job Status

cURL

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

200

{
  "success": true,
  "jobId": "<string>",
  "status": "<string>",
  "totalLeads": 123,
  "leadsUrl": "<string>"
}

Path Parameters

jobId · string · required

The job ID returned from POST /api/enrich. Starts with run_

Request

cURL

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

Response

success · boolean

Whether the request was successful

jobId · string

The job ID

status · string

Job status: QUEUED, EXECUTING, COMPLETED, or FAILED

totalLeads · number

Number of leads (when completed)

leadsUrl · string

URL to fetch leads (when completed)

Executing

{
  "success": true,
  "jobId": "run_cm5x8k9j0000108l4g2h5h3k2",
  "status": "EXECUTING",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "startedAt": "2024-01-15T10:30:05.000Z"
}

Completed

{
  "success": true,
  "jobId": "run_cm5x8k9j0000108l4g2h5h3k2",
  "status": "COMPLETED",
  "totalLeads": 25,
  "leadsUrl": "/api/enrich/run_cm5x8k9j0000108l4g2h5h3k2/leads",
  "finishedAt": "2024-01-15T10:35:00.000Z"
}

Failed

{
  "success": true,
  "jobId": "run_cm5x8k9j0000108l4g2h5h3k2",
  "status": "FAILED",
  "error": {
    "message": "Invalid Sales Navigator URL"
  }
}