# Stop async ES|QL query

**POST /_query/async/{id}/stop**

This API interrupts the query execution and returns the results so far.
If the Elasticsearch security features are enabled, only the user who first submitted the ES|QL query can stop it.

[External documentation](https://www.elastic.co/docs/explore-analyze/query-filter/languages/esql)

## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Api key auth
- Basic auth
- Bearer auth


## Parameters

### Path parameters
- **id** (string)
  The unique identifier of the query.
  A query ID is provided in the ES|QL async query API response for a query that does not complete in the designated time.
  A query ID is also provided when the request was submitted with the `keep_on_completion` parameter set to `true`.

### Query parameters
- **drop_null_columns** (boolean)
  Indicates whether columns that are entirely `null` will be removed from the `columns` and `values` portion of the results.
  If `true`, the response will include an extra section under the name `all_columns` which has the name of all the columns.


## Responses
### 200


#### Body: application/json (object)
- **took** (number)

- **is_partial** (boolean)

- **all_columns** (array[object])

- **columns** (array[object])

- **values** (array[array])

- **_clusters** (object)
  Cross-cluster search information. Present if `include_ccs_metadata` was `true` in the request
  and a cross-cluster search was performed.
- **profile** (object)
  Profiling information. Present if `profile` was `true` in the request.
  The contents of this field are currently unstable.


[Powered by Bump.sh](https://bump.sh)