---
title: "List Escalations"
method: GET
path: "/bots/{bot_id}/escalations"
tags: ["bots"]
---

# List Escalations

`GET /bots/{bot_id}/escalations`

## Request

- Base URL: `https://speaking.meetingbaas.com`
- URL: `https://speaking.meetingbaas.com/bots/{bot_id}/escalations`
- Auth: API key in header `x-meeting-baas-api-key`
- TypeScript: <https://skmtc.dev/meeting-baas/apis/meeting-baas-api/docs/bots/:bot_id/escalations/get.ts> (a function with typed inputs; its response is checked against the schema)

The decisions the bot has handed back to its owner during this call.

Each entry carries the question, its category, who asked, and the owner's
answer once one was posted. The same list is in the call-end event. Only
the API key that created the bot may read it.

## Path parameters

- `bot_id` string, required

## Response `200`

Successful Response

- Escalation[]
  - `escalation_id` string, required
  - `question` string, required: The exact decision asked for, with amounts, names and dates
  - `category` 'spending' | 'commitment' | 'approval' | 'scheduling' | 'information' | 'other', required
  - `context` string: What led to the question and who asked, in one or two sentences
  - `asked_by` string, nullable: The participant who asked, when known
  - `number` integer, nullable: 1-based position among this bot's escalations
  - `created_at` number, required: Unix timestamp of when the bot raised it
  - `status` 'pending' | 'answered'
  - `response` string, nullable: The owner's answer, once posted
  - `decision` 'approved' | 'declined' | 'deferred' | 'info', nullable: How the owner decided, when it was a yes/no question
  - `answered_at` number, nullable: Unix timestamp of the owner's answer

## Other responses

- `404`: No live bot with that ID
- `422`: Validation Error

## Changes

- **2026-11-09** `1a4957849576`: 11 info
  - added the optional property `items/answered_at` to the response with the `200` status
  - added the optional property `items/asked_by` to the response with the `200` status
  - added the optional property `items/context` to the response with the `200` status
  - added the optional property `items/decision` to the response with the `200` status
  - …7 more
- **2026-10-30** `e496ccb3de9f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/meeting-baas/apis/meeting-baas-api/changes/bots/:bot_id/escalations/get.md)

---

[API](https://skmtc.dev/meeting-baas/apis/meeting-baas-api.md) - [All operations](https://skmtc.dev/meeting-baas/apis/meeting-baas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/meeting-baas/apis/meeting-baas-api/revisions/1a4957849576?raw)