---
title: "Get alarm"
method: GET
path: "/v2/Alarms/{Sid}"
---

# Get alarm

`GET /v2/Alarms/{Sid}`

## Request

- Base URL: `https://monitor.twilio.com`
- URL: `https://monitor.twilio.com/v2/Alarms/{Sid}`
- Auth: HTTP basic

## Path parameters

- `Sid` string, required

## Response `200`

Ok

- MonitorV2AlarmBody: Alarm response body
  - `friendlyName` string, required: Friendly name for alarm
  - `queryType` 'ERROR_CODE' | 'LOG_LEVEL' | 'ALL', required: Type of query
  - `query` string: Value to query for
  - `triggerValue` integer, required: Threshold to send customer alarm notification
  - `timeWindow` 'FIVE_MINS' | 'FIFTEEN_MINS' | 'ONE_HOUR' | 'TWELVE_HOURS' | 'ONE_DAY', required: Time window for alarm to trigger
  - `email` string[]: Email notifications to send
  - `webhook` string, uri: Webhook notification to send
  - `consoleIndicator` boolean: Whether to send console notifications
  - `description` string, required: Description for the alarm.
  - `enabled` boolean, required: Is alarm enbled? Default is true.
  - `product` string, required: Product the alarm is related to.
  - `alertConfigSid` string, required: Sid for the alarm
  - `dateUpdated` string, date-time, required: The date and time in UTC when the alarm was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format
  - `dateCreated` string, date-time, required: The date and time in UTC when the alarm was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.

## Other responses

- `400`: BAD REQUEST
- `401`: UNAUTHORIZED
- `404`: NOT FOUND
- `429`: TOO MANY REQUEST
- `500`: INTERNAL SERVER ERROR

## Changes

- **2025-05-05** (v2) `2d0ce84b9930`: 3 info
  - added the required property `alertConfigSid` to the response with the `200` status
  - added the required property `dateCreated` to the response with the `200` status
  - added the required property `dateUpdated` to the response with the `200` status
- **2024-12-05** (v2) `7811ecfc26f4`: 35 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `404` status
  - added the optional property `code` to the response with the `429` status
  - …31 more

[Operation history](https://skmtc.dev/twilio/apis/twilio-monitor/changes/v2/Alarms/:Sid/get.md)

---

[API](https://skmtc.dev/twilio/apis/twilio-monitor.md) - [All operations](https://skmtc.dev/twilio/apis/twilio-monitor/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/twilio-monitor/revisions/9c4c6ced36aa?raw)
