# Get anomaly detection job results for buckets


**POST /_ml/anomaly_detectors/{job_id}/results/buckets/{timestamp}**

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

<div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/_ml/anomaly_detectors/{job_id}/results/buckets</span>
                      </div>
                    <div>
                      <span class="operation-verb post">POST</span>
                      <span class="operation-path">/_ml/anomaly_detectors/{job_id}/results/buckets</span>
                      </div>
                    <div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/_ml/anomaly_detectors/{job_id}/results/buckets/{timestamp}</span>
                      </div>
                    <div>
                      <span class="operation-verb post">POST</span>
                      <span class="operation-path">/_ml/anomaly_detectors/{job_id}/results/buckets/{timestamp}</span>
                      </div>
                    

The API presents a chronological view of the records, grouped by bucket.

## Required authorization

* Cluster privileges: `monitor_ml`



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


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


## Parameters

### Path parameters
- **job_id** (string)
  Identifier for the anomaly detection job.
- **timestamp** (string | number)
  The timestamp of a single bucket result. If you do not specify this
  parameter, the API returns information about all buckets.

### Query parameters
- **anomaly_score** (number)
  Returns buckets with anomaly scores greater or equal than this value.
- **desc** (boolean)
  If `true`, the buckets are sorted in descending order.
- **end** (string | number)
  Returns buckets with timestamps earlier than this time. `-1` means it is
  unset and results are not limited to specific timestamps.
- **exclude_interim** (boolean)
  If `true`, the output excludes interim results.
- **expand** (boolean)
  If true, the output includes anomaly records.
- **from** (number)
  Skips the specified number of buckets.
- **size** (number)
  Specifies the maximum number of buckets to obtain.
- **sort** (string)
  Specifies the sort field for the requested buckets.
- **start** (string | number)
  Returns buckets with timestamps after this time. `-1` means it is unset
  and results are not limited to specific timestamps.

### Body: application/json (object)

- **anomaly_score** (number)
  Refer to the description for the `anomaly_score` query parameter.
- **desc** (boolean)
  Refer to the description for the `desc` query parameter.
- **end** (string | number)
  Refer to the description for the `end` query parameter.
- **exclude_interim** (boolean)
  Refer to the description for the `exclude_interim` query parameter.
- **expand** (boolean)
  Refer to the description for the `expand` query parameter.
- **page** (object)

- **sort** (string)
  Refer to the desription for the `sort` query parameter.
- **start** (string | number)
  Refer to the description for the `start` query parameter.


## Responses
### 200


#### Body: application/json (object)
- **buckets** (array[object])

- **count** (number)



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