---
cuppy_hub: salesforce
cuppy_path: reference/official/data360/data-cloud-query-guide/references/data-cloud-query-api-reference/query-api-v3-get-query.md
cuppy_section: docs
cuppy_doc: 343P-W5S1
cuppy_doc_uuid: a35ffed0-7ba8-47d4-b6c6-bd7850c5a653
cuppy_permalink: https://cuppy.io/salesforce/d/343P-W5S1
cuppy_version: 1
cuppy_updated: 2026-10-23T16:16:52.575Z
cuppy_canonical: https://cuppy.io/salesforce/docs/reference/official/data360/data-cloud-query-guide/references/data-cloud-query-api-reference/query-api-v3-get-query
cuppy_mcp: https://cuppy.io/mcp
cuppy_body_sha256: 1631afbb5798db88a46a4d075a8b48c4ad51d78f497fcacc0759a125bec4b663
# cuppy_body_sha256 is over the document body ALONE, excluding both generated blocks.
---

> Mirror of <https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/query-api-v3-get-query.html> (Salesforce, Data 360 Query Guide), read 2026-10-23. Salesforce's own page is the authority; this copy exists because that site refuses non-browser readers.

## Get SQL Query Status

Use the `GET /api/v3/query/{queryId}` endpoint of the Data 360 Query API to check the execution status of a submitted query. Poll this endpoint after submitting an ASYNC or timed-out ADAPTIVE query to determine when results are ready to retrieve. The response includes completion status, row count, chunk count, and execution statistics.

*   **HTTP Method**: GET
*   **Format**: REST
*   **URI**: `/api/v3/query/{queryId}`

| Parameter | Type | Description |
| --- | --- | --- |
| `queryId` | string | Required. The unique identifier of the query. Returned in the `x-hyperdb-status` response header from `POST /api/v3/query`. Example: `MTAuMjcuMTgxLjE0OTo3NDg0_1cfc8d35`. |

| Parameter | Type | Description |
| --- | --- | --- |
| `waitTimeMs` | integer | (Optional) How long to wait for a status change before returning, in milliseconds. Default and maximum: `10000` (10 seconds). |

| Header | Value |
| --- | --- |
| `Authorization` | `Bearer {accessToken}` |

| Field | Description |
| --- | --- |
| `queryId` | Unique identifier for the query |
| `completionStatus` | Query state: `RUNNING` (still executing), `RESULTS_PRODUCED` (complete but not yet durably stored), or `FINISHED` (persisted to storage, results retrievable for the full expiration window) |
| `chunkCount` | Total number of result chunks available |
| `rowCount` | Total rows in the result set |
| `progress` | Completion fraction from 0 to 1 |
| `expirationTime` | ISO 8601 timestamp when results expire |
| `executionStats` | Object containing `wallClockTime` and `rowsProcessed` |

This example shows a status poll request and response.

*   [Submit SQL Query](https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/query-api-v3-post.html)
*   [Get SQL Query Rows](https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/query-api-v3-get-rows.html)
*   [Query Services Status Codes](https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-queryservices-statuscodes.html)


---
<!-- cuppy -->
You are reading one file. The same content is free over MCP at https://cuppy.io/mcp with no signup: ranked search across all 376 documents in this hub, the merged view when you work in a layer, known workarounds matched to the error you hit, and depth control so you spend tokens on what you need. Start with the `_hello` tool. How to connect: https://cuppy.io/salesforce/ Something wrong in this document? Report it with the `session feedback` tool on the same endpoint.
<!-- /cuppy -->