get
https://{app-url}{}/api/v2/anomalies
Retrieve anomalies
Retrieve anomalies based on a search query. If no query is provided, all anomalies in the account are returned.
This endpoint supports filtering and retrieving multiple anomalies based on their properties. All parameters are passed as query parameters; the request does not include a body.
| Argument | Description |
|---|---|
| q * (string) | Search query — include only anomalies of abnormal metrics that match the given query. |
| startDate (integer) | Filter anomalies that started after the given time (inclusive). Units: epoch seconds. |
| endDate (integer) | Relevant when requesting closed anomalies. Returns anomalies that started before the given time (inclusive). Units: epoch seconds. |
| state (string) | Anomaly state: {open, closed, both}. Default: both. |
| resolution (string) | Include anomalies by timescale. Supported values: {short (1 min), medium (5 min), long (1 hour), longlong (1 day), weekly}. Provide as a comma-separated list (e.g., short,medium). Default: medium. |
| durationUnit (string) | Time unit for duration: {seconds, minutes, hours, days}. |
| durationValue (integer) | Minimum anomaly duration. Units are based on durationUnit. |
| score (number) | Minimum anomaly score in the range [0,1] (inclusive). |
| bookmark (string) | Filter by bookmarks: all (bookmarked anomalies), none (no bookmarks), user_id (bookmarked by a specific user), * (not bookmarked by the given user). |
| sort (string) | Sort field: {startDate, endDate, duration, score}. |
| order (string) | Sort order: {asc, desc}. |
| index (integer) | Starting index for pagination. |
| size (integer) | Number of anomalies to fetch starting from index (pagination). |
| valueDirection (string) | Direction of anomaly breach: {down, up, both}. |
| deltaType (string) | Type of delta relative to baseline: {percentage, absolute}. |
| delta (number) | Delta of the anomaly peak relative to the baseline. Units depend on deltaType. |