Skip to main content
GET
/
v1
/
alarms
/
history
List Alarm Events
curl --request GET \
  --url https://api.bland.ai/v1/alarms/history \
  --header 'authorization: <authorization>'
{
  "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
}

​
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.
{
  "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
}