> ## 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 Alarms

> List alarm configurations for 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`.

### Response

**data.alarms** `array`

Alarm configuration objects for your organization.

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

Alarm configuration ID.

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

Metric this alarm tracks. One of: `latency`, `api_errors`, `call_length`.

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

Trigger threshold for this metric.

**data.alarms\[].enabled** `boolean`

Whether this alarm is enabled.

**data.alarms\[].webhook\_config** `object|null`

Webhook settings object, including `url` and optional masked `headers`.

**data.alarms\[].email\_addresses** `string[]`

Email recipients for notifications.

**data.alarms\[].sms\_numbers** `string[]`

SMS recipients for notifications.

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

ISO timestamp for when the alarm was created.

**data.alarms\[].updated\_at** `string`

ISO timestamp for when the alarm was last updated.

**errors** `null|array`

`null` on success, otherwise an array of error objects.

```json Success theme={null}
{
  "data": {
    "alarms": [
      {
        "id": "b14f7f49-8af2-4d7b-9f51-e3b42b2f91c6",
        "metric_type": "latency",
        "enabled": true,
        "threshold": 1,
        "webhook_config": {
          "url": "https://example.com/webhooks/alarms",
          "headers": {
            "Content-Type": "appl***"
          }
        },
        "email_addresses": ["alerts@example.com"],
        "sms_numbers": ["+15555550123"],
        "created_at": "2026-03-10T00:26:37.707Z",
        "updated_at": "2026-03-10T00:26:37.707Z"
      }
    ]
  },
  "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.