get-query-status
Written by
Updated at July 1, 2026
This method returns the query status. You can use it to track query progress and retrieve the results once it is completed.
When using the HTTP API, you must authenticate by providing the required headers. You can also specify optional headers to control how requests are executed. The HTTP API may return errors.
Request
GET request to /queries/{query_id}/status?project={folder_id}, where {folder_id} is the folder ID and {query_id} is the query ID.
Response
If successful, the response returns an HTTP 200 status code and the query status, i.e., RUNNING, COMPLETED, or FAILED.
{
"status": "RUNNING"
}
Example
Query:
curl \
--request 'GET' \
--header 'accept: application/json' \
'https://api.yandex-query.cloud.yandex.net/api/fq/v1/queries/cseugn35bc3r********/status?project=b1gaue5b382m********'
Response:
{
"status": "RUNNING"
}