/jobs/:job_id

Step 2: Request a job's status until it is finished.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

List of status codes

Status codeMeaning
newThe job was just created and will be scheduled soon.
workingThe job was scheduled and is being worked on according to the scheduling.
finishingAll data for the job has been collected and the results are being compiled.
finishedThe job was processed completely and is ready to be downloaded.
cancelledThe job's processing was cancelled. It cannot be downloaded. No credits have been booked for this job.

Further status codes may exist or be added later.

List of error codes

Error codeMeaning
unauthorizedNo token provided or token is not valid.
job not foundNo job could be found for a given job_id.
job forbiddenUser with a given token is not allowed to access the the given job.
too many requestsUsage of this endpoint is rate-limited to 60 requests per minute.

Further error codes may be added.

Path Params
string
required
Defaults to See step 1

The id of a recently created job. Found in the JSON response of the create request.

Query Params
string
required

Your API key

Responses

Language
Credentials
Query
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json