Yandex Cloud
Documentation
PresentationContact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.
Yandex Query
  • Yandex Query shutdown
  • Access management
  • Pricing policy
    • Terraform
    • SDK
      • Overview
      • Authentication
        • All methods
        • create-query
        • get-query
        • get-query-status
        • stop-query
        • get-query-results
      • YQL to JSON type mapping
    • Apache Airflow™
  • Integrations
  • Audit Trails events
  • FAQ

In this article:

  • Request
  • Response
  • Example
  1. Reference
  2. HTTP API
  3. Methods
  4. get-query-status

get-query-status

Written by
Yandex Cloud
Updated at July 1, 2026
View in Markdown
  • Request
  • Response
  • Example

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.

RequestRequest

GET request to /queries/{query_id}/status?project={folder_id}, where {folder_id} is the folder ID and {query_id} is the query ID.

ResponseResponse

If successful, the response returns an HTTP 200 status code and the query status, i.e., RUNNING, COMPLETED, or FAILED.

{
  "status": "RUNNING"
}

ExampleExample

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"
}

Was the article helpful?

Previous
get-query
Next
stop-query
© 2026 Direct Cursus Technology L.L.C.