---
title: "List open/broken call promises for agent handoff tracking — hotel / MSP sales demo. Idle $0."
method: GET
path: "/v1/pbx/promises"
tags: ["PBX Search"]
---

# List open/broken call promises for agent handoff tracking — hotel / MSP sales demo. Idle $0.

`GET /v1/pbx/promises`

## Request

- Base URL: `https://api.temsor.com`
- URL: `https://api.temsor.com/v1/pbx/promises`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

GET /v1/pbx/promises?status=open returns open/unclosed promises with transfer/handoff path for orchestration. Scoped by x-temsor-pbx-key when set. Idle $0. No live PSTN.

**Credits per call:** 1 · **Operation id:** `pbx_promises`

In the GET form every field is a query parameter; object and array fields are JSON-encoded.

## Query parameters

- `status` 'open' | 'kept' | 'broken' | 'unknown' | 'all' | 'closed': Promise status filter; closed = kept|broken. Sales demo uses open.

## Response `200`

Success

- object
  - `ok` unknown, required
  - `data` object, required
    - `status` string, required
    - `pbx_id` string, nullable, required
    - `count` integer, required
    - `promises` object[], required
      - `id` string, required
      - `call_id` string, required
      - `text` string, required
      - `who` string, required
      - `when_iso` string, nullable, required
      - `status` 'open' | 'kept' | 'broken' | 'unknown', required
      - `ext` string, nullable, required
      - `pbx_id` string, required
      - `competitor` string, nullable
      - `emotion` string, nullable
      - `transfer_count` integer, required
      - `graph` object
        - `call_id` string, required
        - `transfer_count` integer, required
        - `edges` object[], required
          - `from_ext` string, nullable, required
          - `to_ext` string, nullable, required
          - `t_ms` number, nullable, required
          - `reason` string, nullable, required
        - `path` string, required
        - `path_tr` string, required
        - `stuck_at_ext` string, nullable, required
        - `stuck_tr` string, nullable, required
      - `path` string
      - `path_tr` string
      - `stuck_at_ext` string, nullable
      - `markers` string[]
      - `confidence` string
      - `closed_at` string, nullable
      - `close_note` string, nullable
    - `note` string, required
  - `meta` object
    - `credits` integer
    - `cached` boolean
    - `requestId` string
    - `durationMs` integer

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `429`: Rate limit exceeded — wait `Retry-After` seconds. The RateLimit headers are sent here too.

---

[API](https://skmtc.dev/temsor/apis/temsor-api.md) · [All operations](https://skmtc.dev/temsor/apis/temsor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/temsor/apis/temsor-api/revisions/19702107e15a?raw)