# Query watches


**POST /_watcher/_query/watches**

**All methods and paths for this operation:**

<div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/_watcher/_query/watches</span>
                      </div>
                    <div>
                      <span class="operation-verb post">POST</span>
                      <span class="operation-path">/_watcher/_query/watches</span>
                      </div>
                    

Get all registered watches in a paginated manner and optionally filter watches by a query.

Note that only the `_id` and `metadata.*` fields are queryable or sortable.

## Required authorization

* Cluster privileges: `monitor_watcher`



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


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


## Parameters



### Body: application/json (object)

- **from** (number)
  The offset from the first result to fetch.
  It must be non-negative.
- **size** (number)
  The number of hits to return.
  It must be non-negative.
- **query** (object)
  A query that filters the watches to be returned.
- **sort** (string | object | array[string | object])
  One or more fields used to sort the search results.
- **search_after** (array[number | string | boolean | null])
  Retrieve the next page of hits using a set of sort values from the previous page.


## Responses
### 200


#### Body: application/json (object)
- **count** (number)
  The total number of watches found.
- **watches** (array[object])
  A list of watches based on the `from`, `size`, or `search_after` request body parameters.


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