---
title: "get query status"
method: GET
path: "/queries/{query_id}/status"
---

# get query status

`GET /queries/{query_id}/status`

## Query parameters

- `db` string
- `project` string

## Headers

- `x-request-id` string
- `Authorization` string

## Response `200`

OK

- object
  - `status` 'RUNNING' | 'COMPLETED' | 'FAILED', required

## Other responses

- `400` — Bad Request

## Changes

- **2022-11-24** `a67282f76c41` — 1 warning
  - removed the optional property `details/items/status` from the response with the `400` status
- **2022-11-10** `88d79b1ba69f` — 1 info
  - added the optional property `details/items/status` to the response with the `400` status

[Change history](https://skmtc.dev/shmel1k/apis/yq/changes/queries/:query_id/status/get.md)

---

[API](https://skmtc.dev/shmel1k/apis/yq.md) · [All operations](https://skmtc.dev/shmel1k/apis/yq/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/shmel1k/yq/revisions/036b0af69dee/schema)