---
title: "List Alerts"
method: GET
path: "/api/v2/alerts"
tags: ["Alerts"]
---

# List Alerts

`GET /api/v2/alerts`

Retrieves a list of all alerts for the authenticated team

## Response `200`

Successfully retrieved alerts

- AlertsListResponse
  - `data` AlertResponse[] — List of alert objects.
    - `dashboardId` string, nullable — Dashboard ID for tile-based alerts.
    - `tileId` string, nullable — Tile ID for tile-based alerts. Must be a line, stacked bar, or number type tile.
    - `savedSearchId` string, nullable — Saved search ID for saved_search alerts.
    - `groupBy` string, nullable — Group-by key for saved search alerts.
    - `threshold` number — Threshold value for triggering the alert. For between and not_between threshold types, this is the lower bound.
    - `thresholdMax` number, nullable — Upper bound for between and not_between threshold types. Required when thresholdType is between or not_between, must be >= threshold.
    - `interval` '1m' | '5m' | '15m' | '30m' | '1h' | '6h' | '12h' | '1d' — Evaluation interval.
    - `scheduleOffsetMinutes` integer, nullable — Offset from the interval boundary in minutes. For example, 2 with a 5m interval evaluates windows at :02, :07, :12, etc. (UTC).
    - `scheduleStartAt` string, date-time, nullable — Absolute UTC start time anchor. Alert windows start from this timestamp and repeat every interval.
    - `source` 'saved_search' | 'tile' — Alert source type.
    - `thresholdType` 'above' | 'below' | 'above_exclusive' | 'below_or_equal' | 'equal' | 'not_equal' | 'between' | 'not_between' — Threshold comparison direction.
    - `channel` AlertChannel
      - `type` 'webhook', required — Channel type.
      - `webhookId` string, required — Webhook destination ID.
    - `name` string, nullable — Human-friendly alert name.
    - `message` string, nullable — Alert message template.
    - `id` string — Unique alert identifier.
    - `state` 'ALERT' | 'OK' | 'INSUFFICIENT_DATA' | 'DISABLED' — Current alert state.
    - `teamId` string — Team identifier.
    - `silenced` AlertSilenced — Silencing metadata.
      - `by` string, nullable — User ID who silenced the alert.
      - `at` string, date-time — Silence start timestamp.
      - `until` string, date-time — Silence end timestamp.
    - `executionErrors` AlertExecutionError[], nullable — Errors recorded during the most recent alert execution, if any.
      - `timestamp` string, date-time, required — When the error occurred.
      - `type` 'QUERY_ERROR' | 'WEBHOOK_ERROR' | 'INVALID_ALERT' | 'UNKNOWN', required — Category of error recorded during alert execution.
      - `message` string, required — Human-readable error message.
    - `createdAt` string, date-time, nullable — Creation timestamp.
    - `updatedAt` string, date-time, nullable — Last update timestamp.

## Other responses

- `401` — Unauthorized

## Changes

- **2026-04-17** `49ba4aeaa9b4` — 1 info
  - added the optional property `data/items/allOf[subschema #2]/executionErrors` to the response with the `200` status
- **2026-04-17** `36a5514b1745` — 2 warning, 1 info
  - added the new `between` enum value to the `data/items/allOf[#/components/schemas/Alert]/thresholdType` response property for the response status `200`
  - added the new `not_between` enum value to the `data/items/allOf[#/components/schemas/Alert]/thresholdType` response property for the response status `200`
  - added the optional property `data/items/allOf[#/components/schemas/Alert]/thresholdMax` to the response with the `200` status
- **2026-04-16** `dbf09188d84e` — 4 warning
  - added the new `above_exclusive` enum value to the `data/items/allOf[#/components/schemas/Alert]/thresholdType` response property for the response status `200`
  - added the new `below_or_equal` enum value to the `data/items/allOf[#/components/schemas/Alert]/thresholdType` response property for the response status `200`
  - added the new `equal` enum value to the `data/items/allOf[#/components/schemas/Alert]/thresholdType` response property for the response status `200`
  - added the new `not_equal` enum value to the `data/items/allOf[#/components/schemas/Alert]/thresholdType` response property for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/hyperdxio/apis/hyperdx-external-api/changes/api/v2/alerts/get.md)

---

[API](https://skmtc.dev/hyperdxio/apis/hyperdx-external-api.md) · [All operations](https://skmtc.dev/hyperdxio/apis/hyperdx-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hyperdxio/hyperdx-external-api/revisions/49ba4aeaa9b4/schema)