Skip to main content
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.
  • Input: Provide the job_id returned 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.
  • Poll at a sensible interval rather than continuously — large jobs can run for a long time.
  • Store the job_id returned at submission; it is the only handle on the run.
  • Check status before reading results — 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_usage to track consumption per job.
  • Cancel jobs you no longer need with Cancel job rather than letting them run to completion.
Jobs run for a maximum of 24 hours. See async jobs for the full submit → poll → retrieve flow.

Authorizations

api_key
string
header
required

Path Parameters

job_id
string
required

Response

Successful Response

job_id
string
required
status
string
required
input
V2JobInput · object
required
timing
V2JobTiming · object
required
additional_data
Additional Data · object
credit_usage
V2JobCreditUsage · object
results
V2JobResults · object
error
Error · object