get
/api/v2/jobs/{id}Python SDK method:
client.jobs.get_job_status(job_id)Get job status
Returns the current status of an async job. Returns 200 for in-progress (PENDING, QUEUED, RUNNING), terminal (FAILED, CANCELED), and DONE jobs. When the job is DONE, the result URL is available in the response body.
Input Parameters
| Name | Location | Type | Values | Description | Value Required |
|---|---|---|---|---|---|
id | path | string | - | Resource identifier. | Y |
Success Responses
200 response: object
Current job status.
| Name | Type | Description |
|---|---|---|
error | object | Details about why the job failed (RFC 7807 format), or null if it succeeded. |
id | string | Unique job identifier. |
links | object | Navigation URLs for polling and result retrieval. |
status | string | Current job lifecycle state: PENDING, QUEUED, RUNNING, DONE, FAILED, CANCELED, or NOT_FOUND. |
Response Errors
| HTTP Status Code | Reason |
|---|---|
| 400 | Problem Details error. |
| 401 | Problem Details error. |
| 429 | The request rate limit has been exceeded. |
| 500 | Problem Details error. |