[Yandex Cloud documentation](../../../index.md) > [Yandex Query](../../index.md) > Reference > [HTTP API](../index.md) > [Methods](index.md) > get-query-status

# get-query-status

This method returns the query status. You can use it to track query progress and [retrieve the results](get-query-results.md) once it is completed.

When using the HTTP API, you must [authenticate](../auth.md) by providing the [required headers](../index.md#mandatory-headers). You can also specify [optional headers](../index.md#optional-headers) to control how requests are executed. The HTTP API may return [errors](../index.md#errors).

## Request {#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 {#response}

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

```json
{
  "status": "RUNNING"
}
```

## Example {#example}

Query:

```json
curl \
  --request 'GET' \
  --header 'accept: application/json' \
  'https://api.yandex-query.cloud.yandex.net/api/fq/v1/queries/cseugn35bc3r********/status?project=b1gaue5b382m********'
```

Response:

```json
{
  "status": "RUNNING"
}
```