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.
/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.
1GET https://{dne_cdpInstanceUrl}/api/v3/query/MTAuMjcuMTgxLjE0OTo3NDg0_1cfc8d35-464c-9185-1f41-3eb638a71f7a
2Authorization: Bearer {accessToken}1{
2 "queryId": "MTAuMjcuMTgxLjE0OTo3NDg0_1cfc8d35-464c-9185-1f41-3eb638a71f7a",
3 "completionStatus": "RESULTS_PRODUCED",
4 "chunkCount": 1,
5 "rowCount": 10,
6 "progress": 1,
7 "expirationTime": "2025-09-26T10:55:07.438Z",
8 "executionStats": {
9 "wallClockTime": 0.204560264,
10 "rowsProcessed": 10
11 }
12}
j