Yandex Cloud
Search
Discuss with expertTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Yandex Query
  • 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.