List Alarm Events

curl --request GET \
  --url https://api.bland.ai/v1/alarms/history \
  --header 'authorization: <authorization>'

const options = {method: 'GET', headers: {authorization: '<authorization>'}};

fetch('https://api.bland.ai/v1/alarms/history', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bland.ai/v1/alarms/history",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bland.ai/v1/alarms/history"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.bland.ai/v1/alarms/history")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

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

GET

alarms

history

List Alarm Events

curl --request GET \
  --url https://api.bland.ai/v1/alarms/history \
  --header 'authorization: <authorization>'

const options = {method: 'GET', headers: {authorization: '<authorization>'}};

fetch('https://api.bland.ai/v1/alarms/history', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bland.ai/v1/alarms/history",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bland.ai/v1/alarms/history"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.bland.ai/v1/alarms/history")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "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

string

required

Your API key for authentication.

Query Parameters

string

Optional metric filter. Allowed values: latency, api_errors, call_length.

integer

default:"50"

Number of events to return. Must be between 1 and 200.

Response

array

Recent alarm event entries.

string

Alarm event ID.

string

Metric associated with this event.

string

Previous alarm state before transition.

string

New alarm state after transition.

number

Deviation from baseline at evaluation time.

number

Threshold in effect for this event.

string|null

Correlation ID for alarm/recovery pairing when present.

string|null

Event type when a notification/state event was recorded (for example deviation_detected or deviation_recovered).

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
}

Docs for agents: llms.txt

⌘I

Basic Tutorials

Calls

Voices & Text to Speech

Conversational Pathways

Knowledge Bases

Numbers

Blocked Numbers

Widgets

Tools

Contacts

Memory

Node tests

Agent Testing

Evals

Guard Rails

Web Agents

Live Translation

Custom Twilio Accounts

Batches

Prompts

Account

Organizations

Messaging

SIP Trunks

Custom Dialing Pools

Personas

Citation Schemas

Alarms

Triage

List Alarm Events

Headers

Query Parameters

Response

​Headers

​Query Parameters

​Response

Headers

Query Parameters

Response