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

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Path Parameters

<ParamField path="id" type="string" required>
  Alarm configuration ID.
</ParamField>

### Response

<ResponseField name="data.alarm" type="object">
  Alarm configuration object.
</ResponseField>

<ResponseField name="data.alarm.id" type="string">
  Alarm configuration ID.
</ResponseField>

<ResponseField name="data.alarm.metric_type" type="string">
  Metric this alarm tracks.
</ResponseField>

<ResponseField name="data.alarm.threshold" type="number">
  Trigger threshold for this metric.
</ResponseField>

<ResponseField name="data.alarm.enabled" type="boolean">
  Whether this alarm is enabled.
</ResponseField>

<ResponseField name="data.alarm.webhook_config" type="object|null">
  Webhook settings object. Header values may be masked in API responses.
</ResponseField>

<ResponseField name="data.alarm.email_addresses" type="string[]">
  Email recipients for notifications. Can be an empty array if none are configured.
</ResponseField>

<ResponseField name="data.alarm.sms_numbers" type="string[]">
  SMS recipients for notifications. Can be an empty array if none are configured.
</ResponseField>

<ResponseField name="data.alarm.created_at" type="string">
  ISO creation timestamp.
</ResponseField>

<ResponseField name="data.alarm.updated_at" type="string">
  ISO update timestamp.
</ResponseField>

<ResponseExample>
  ```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
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)