---
title: "getQuery"
method: GET
path: "/dataKiosk/2023-11-15/queries/{queryId}"
tags: ["Data Kiosk v2023-11-15"]
---

# getQuery

`GET /dataKiosk/2023-11-15/queries/{queryId}`

Returns query details for the query specified by the `queryId` parameter. See the `createQuery` operation for details about query retention.

**Usage Plan:**

| Rate (requests per second) | Burst |
| ---- | ---- |
| 2.0 | 15 |

The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).

## Path parameters

- `queryId` string, required

## Response `200`

Success.

- Query — Detailed information about the query.
  - `queryId` string, required — The query identifier. This identifier is unique only in combination with a selling partner account ID.
  - `query` string, required — The submitted query.
  - `createdTime` string, date-time, required — The date and time when the query was created, in ISO 8601 date time format.
  - `processingStatus` 'CANCELLED' | 'DONE' | 'FATAL' | 'IN_PROGRESS' | 'IN_QUEUE', required — The processing status of the query.
  - `processingStartTime` string, date-time — The date and time when the query processing started, in ISO 8601 date time format.
  - `processingEndTime` string, date-time — The date and time when the query processing completed, in ISO 8601 date time format.
  - `dataDocumentId` string — The data document identifier. This identifier is only present when there is data available as a result of the query. This identifier is unique only in combination with a selling partner account ID. Pass this identifier into the `getDocument` operation to get the information required to retrieve the data document's contents.
  - `errorDocumentId` string — The error document identifier. This identifier is only present when an error occurs during query processing. This identifier is unique only in combination with a selling partner account ID. Pass this identifier into the `getDocument` operation to get the information required to retrieve the error document's contents.
  - `pagination` object — When a query produces results that are not included in the data document, pagination occurs. This means the results are divided into pages. To retrieve the next page, you must pass a `CreateQuerySpecification` object with `paginationToken` set to this object's `nextToken` and with `query` set to this object's `query` in the subsequent `createQuery` request. When there are no more pages to fetch, the `nextToken` field will be absent.
    - `nextToken` string — A token that can be used to fetch the next page of results.

## Other responses

- `400` — Request has missing or invalid parameters and cannot be parsed.
- `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
- `404` — The resource specified does not exist.
- `413` — The request size exceeded the maximum accepted size.
- `415` — The request payload is in an unsupported format.
- `429` — The frequency of requests was greater than allowed.
- `500` — An unexpected condition occurred that prevented the server from fulfilling the request.
- `503` — Temporary overloading or maintenance of the server.

---

[API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)