---
title: "Get external query state"
method: GET
path: "/query/{request_id}"
tags: ["query"]
---

# Get external query state

`GET /query/{request_id}`

Returns retained state without dispatching build or SQL.

## Path parameters

- `request_id` string, uuid, required

## Response `200`

State-only response

- ExternalQueryStateOnlyResponse
  - `response_type` 'state_only', required
  - `request_id` string, uuid, required
  - `state` 'RECEIVED' | 'PREPARING' | 'CACHE_READY' | 'RUNNING' | 'CANCELLING' | 'CANCELLED' | 'SUCCEEDED' | 'FAILED' | 'UNKNOWN', required
  - `terminal` boolean, required
  - `failure_class` 'invalid_request' | 'unauthorized' | 'snapshot_unavailable' | 'capacity' | 'build_timeout' | 'query_timeout' | 'rate_limited' | 'internal', nullable
  - `retry_after_seconds` integer, nullable

## Other responses

- `401` — Unauthorized
- `404` — Request not found or retained state expired
- `503` — External Query Service outcome is unknown

---

[API](https://skmtc.dev/qlonolink/apis/qaip-apis.md) · [All operations](https://skmtc.dev/qlonolink/apis/qaip-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qlonolink/qaip-apis/revisions/61dc40676905/schema)