Skip to content

Get job processing status with progress

GET/v1/jobs/{id}/status/

Return job processing status with estimated progress.

Path parameters

  • idstringRequired

Returns

200 with a JSON object.

Show response attributesHide response attributes
  • processing_statusstringRequired

    Where the job is in its lifecycle: pending (received, being inspected), queued (accepted, waiting to be processed), processing, completed (the result can be downloaded) or failed (the job's error and error_code say why). completed and failed are final.

  • progressintegerRequired

    Estimated progress percentage from 0 to 100

  • messagestring or nullRequired

    Optional informational message, e.g. when processing takes longer than expected

Errors

Every error has the same JSON body. See Errors for the error codes and when to retry.

  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 410Gone
  • 413Request Entity Too Large
  • 422Unprocessable Entity
  • 429Too Many Requests
  • 500Internal Server Error