---
title: "Retrieve the tasks for Product Admin API requests"
method: GET
path: "/v1/products/tasks/"
tags: ["Get Product Task Status (Synchronous API)"]
---

# Retrieve the tasks for Product Admin API requests

`GET /v1/products/tasks/`

Retrieve the tasks for Product Admin API requests. Specify the conditions using the query parameters to filter your query.

## Query parameters

- `productId` string
- `taskStatus` string — comma separated status
- `beginReceivedTime` string
- `endReceivedTime` string
- `limit` integer
- `startingAfter` string
- `endingBefore` string

## Response `200`

Successful response.

- ProductAdminApiTaskSearchResult
  - `tasks` ProductAdminApiTask[]
    - `taskId` string — The task identifier received in the response when you create or update a product (synchronous API).
    - `receivedTime` string — The date and time when Global Commerce received the task.
    - `finishedTime` string — The date and time when the Global Commerce task finished.
    - `taskStatus` string — The status of the task.
    - `requestType` string — The request type for this task.
    - `products` ProductAdminApiTaskProducts[] — The product information.
      - `productId` string — The product identifier.
      - `externalReferenceId` string — The external reference identifier.
      - `productType` string — The product type.
    - `uri` string
  - `totalSize` integer
  - `previousPage` object — The key and value of the query parameter used to fetch the previous page if there is a previous page.
    - `endingBefore` string — The system uses this task identifier to fetch the task.
  - `nextPage` object — The key and value of the query parameter used to fetch the previous page if there is a previous page.
    - `startingAfter` string — The system uses this task identifier to fetch the task.
  - `searchCriteria` object — criteria used to get the search result. Some criteria have default values even if they were not provided in request.
    - `beginReceivedTime` string — The start date and time when the task request was received.
    - `endReceivedTime` string — The end date and time when the task request was received.
    - `taskStatus` string[]
    - `productId` string — The product identifier. The product identifier only appears if it is used in the search request.
  - `pagination` object
    - `limit` integer
    - `startingAfter` string — A string that marks the beginning of search request. Only present if it is used in search request.
    - `endingBefore` string — A string that marks the end of search request. Only present if it is used in search request.

## Other responses

- `400` — * The query parameter is invalid
- `401` — * The API key is invalid if you are using HTTP Basic Authentication.
- `403` — * The token is invalid if you are using Bearer Token Authentication.

---

[API](https://skmtc.net/digitalriver/apis/commerce-api-suite-admin-apis.md) · [All operations](https://skmtc.net/digitalriver/apis/commerce-api-suite-admin-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalriver/commerce-api-suite-admin-apis/revisions/a6efafc1669c/schema)