Get Job Status
Async jobs
Get job status
GET
Get Job Status
Description
The Get Job Status endpoint returns the current state of an asynchronous job and, once the job has finished, its results. Every.../job endpoint in v2 runs through this shared layer, so the polling pattern is identical no matter which enrichment you submitted.
How It Works
How It Works
- Input: Provide the
job_idreturned when you submitted the job. - Processing: The system looks up the job and reports its current state.
- Output: A structured response containing the job’s status, its input summary, timing, credit usage, and — once complete — its results.
Response Schema
Response Schema
Best Practices
Best Practices
- Poll at a sensible interval rather than continuously — large jobs can run for a long time.
- Store the
job_idreturned at submission; it is the only handle on the run. - Check
statusbefore readingresults— results are only populated once the job has completed. - Expired download link? Just call this endpoint again — each call returns a freshly signed
download_url. The link (expires_at) lasts about an hour; the file itself (file_expires_at) is kept for 7 days after the job finishes. - Read
credit_usageto track consumption per job. - Cancel jobs you no longer need with Cancel job rather than letting them run to completion.