API ReferenceQuery Runner

Get Query Results

Fetches the latest status for a submitted query and, once complete, returns fields and paginated results. This endpoint is the second step of the query-runner flow. First call [`POST /api/connections/{connection_id}/query`](../../../api-reference/query-runner/run-query), then poll this endpoint with the returned ID. Results may be paginated across multiple blobs. When that happens, use the opaque `links.next` and `links.previous` URLs exactly as returned. Do not try to construct the `page` token yourself. If the query is still running, the response may include only status metadata. If the task is complete but the caller is not the same user that created it, the endpoint returns `404`.

Authentication

AuthorizationBasic

This is the Polytomic deployment key (on-premises only)

OR
AuthorizationBearer
This is the Polytomic API key

Path parameters

idstringRequiredformat: "uuid"

Unique identifier of the query task, as returned by POST /api/connections/{connection_id}/query.

Headers

X-Polytomic-VersionstringRequired

Query parameters

pagestringOptional
Opaque pagination token returned in the links.next or links.previous URL of the previous response.

Response

OK
dataobject

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
500
Internal Server Error