Get Job Status

Fetch the status of an asynchronous catalog job. The bulk endpoints below don't apply changes during the request. They queue a job and return its job_id, which you pass to this endpoint to see whether the job has finished and which objects failed.

job_typeStarted by
PRODUCTS_UPSERTPOST /products/bulk_upsert
SKUS_UPSERTPOST /skus/bulk_upsert
SKU_PRICES_UPSERTPOST /prices/bulk_upsert
SKU_PRICES_DELETEDELETE /prices/bulk_delete
PRODUCT_PRICES_UPSERTPOST /products/prices/bulk_upsert
PRODUCT_PRICES_DELETEDELETE /products/prices/bulk_delete
COLLECTIONS_UPSERTPOST /collections/bulk_upsert
COLLECTION_PRODUCTS_UPSERTPOST /collections/products/bulk_upsert
COLLECTION_PRODUCTS_DELETEDELETE /collections/products/bulk_delete
COLLECTION_SKU_DELIVERIES_UPSERTPOST /collections/sku_deliveries/bulk_upsert

job_status is one of:

  • IN_PROGRESS: the job is still being processed.
  • COMPLETED: the job finished without errors.
  • COMPLETED_WITH_ERRORS: the job finished, but some objects were not applied. Each one is listed in errors.
  • FAILED: the job could not be completed.

Errors found while processing the job come back in the errors array of a 200 response, not as an error status code. A 404 means no job with this job_id was found for this account.

Each request costs 1 credit. See Rate limits & throttling.

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

The job_id returned by an asynchronous bulk endpoint. Must be a UUIDv4 string.

Query Params
string
required

JOOR Account ID

Headers
string
required

Authorization token

Responses

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