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

# Get Alarm

> Get a single alarm configuration by ID.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**id** `string` *required*

Alarm configuration ID.

### Response

**data.alarm** `object`

Alarm configuration object.

**data.alarm.id** `string`

Alarm configuration ID.

**data.alarm.metric\_type** `string`

Metric this alarm tracks.

**data.alarm.threshold** `number`

Trigger threshold for this metric.

**data.alarm.enabled** `boolean`

Whether this alarm is enabled.

**data.alarm.webhook\_config** `object|null`

Webhook settings object. Header values may be masked in API responses.

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

Email recipients for notifications. Can be an empty array if none are configured.

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

SMS recipients for notifications. Can be an empty array if none are configured.

**data.alarm.created\_at** `string`

ISO creation timestamp.

**data.alarm.updated\_at** `string`

ISO update timestamp.

```json Success theme={null}
{
  "data": {
    "alarm": {
      "id": "9a6d2ad2-a9c6-4e4a-bde6-4bb6fc22b907",
      "metric_type": "latency",
      "enabled": true,
      "threshold": 0.5,
      "webhook_config": {
        "url": "https://example.com/webhooks/alarms",
        "headers": {
          "Content-Type": "appl***"
        }
      },
      "email_addresses": ["alerts@example.com"],
      "sms_numbers": ["+15555550123"],
      "created_at": "2026-03-12T16:13:02.694Z",
      "updated_at": "2026-03-12T16:34:09.340Z"
    }
  },
  "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.