> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Alarm Events

> Get recent alarm events across all alarms in your organization.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Query Parameters

**metric\_type** `string`

Optional metric filter. Allowed values: `latency`, `api_errors`, `call_length`.

**limit** `integer` (default: 50)

Number of events to return. Must be between `1` and `200`.

### Response

**data.events** `array`

Recent alarm event entries.

**data.events\[].id** `string`

Alarm event ID.

**data.events\[].metric\_type** `string`

Metric associated with this event.

**data.events\[].previous\_state** `string`

Previous alarm state before transition.

**data.events\[].new\_state** `string`

New alarm state after transition.

**data.events\[].deviation** `number`

Deviation from baseline at evaluation time.

**data.events\[].threshold** `number`

Threshold in effect for this event.

**data.events\[].alarm\_id** `string|null`

Correlation ID for alarm/recovery pairing when present.

**data.events\[].event\_type** `string|null`

Event type when a notification/state event was recorded (for example `deviation_detected` or `deviation_recovered`).

**data.events\[].created\_at** `string`

ISO timestamp when the event was recorded.

```json Success theme={null}
{
  "data": {
    "events": [
      {
        "id": "41a53fc5-a9f7-4e6f-a89a-b12e0f9f4c43",
        "metric_type": "latency",
        "previous_state": "RECOVERY_PENDING",
        "new_state": "NORMAL",
        "deviation": 0,
        "threshold": 1,
        "alarm_id": "8b90c6df-5a47-4db5-9ab3-d7f1da30da6e",
        "event_type": "deviation_recovered",
        "created_at": "2026-03-12T01:15:01.393Z"
      }
    ]
  },
  "errors": null
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.