Getting the latest information on a product task

Learn how to verify the successful completion of a specific product task.

The following GET /v1/products/tasks/{taskId} request gets the latest product information for an asynchronous task. It indicates whether the request was completed successfully and lists all products associated with that task. This request requires the task identifier (taskId) provided in the response when you created or updated the product.

You cannot change or modify a product until the create product request completes successfully.

cURL

curl --location --request GET 'https://api.digitalriver.com/v1/products/tasks/{taskId}' \
--header 'Authorization: Basic <API_key>' \
...

200 OK response

The response returns the product data, the task identifier (taskId), the request type (requestType), and task status (taskStatus) in the synchronous response.

{
    "taskId": "ea310126-cba4-46be-9cff-82dded915dbf",
    "products": [
        {
            "id": "50792700080",
            "externalReferenceId": "47f3e694-f638-4263-b97d-f0f921ae20d3",
            "productType": "BASE"
        },
        {
            "id": "50792710080",
            "externalReferenceId": "9f00245b-ccfa-4ca0-805b-13d01b685dfb",
            "productType": "VARIATION"
        },
        {
            "id": "50792720080",
            "externalReferenceId": "43c0d80d-82fe-418f-ad57-0a8688bd7c2f",
            "productType": "VARIATION"
        }
    ],
    "requestType": "CREATE_PRODUCT",
    "taskStatus": "COMPLETED",
    "receivedTime": "2022-08-11T16:32:26.547Z",
    "finishedTime": "2022-08-11T16:32:31.185Z"
}