---
title: "List AMD decisions"
method: GET
path: "/v1/amd/calls"
tags: ["AMD"]
---

# List AMD decisions

`GET /v1/amd/calls`

## Request

- Base URL: `https://api.pyai.com`
- URL: `https://api.pyai.com/v1/amd/calls`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Recent AMD decisions for this org, newest first. Requires `amd:read`. Filter by `session_label` (the opaque tag you passed on the connect URL / TwiML).

## Query parameters

- `limit` integer
- `cursor` string
- `session_label` string

## Response `200`

Paginated AMD decision list

- AmdCallList
  - `object` string
  - `data` AmdCallListItem[]
    - `object` string
    - `call_id` string
    - `session_label` string, nullable: The opaque tag passed on the connect URL / TwiML, if any.
    - `status` 'completed' | 'failed'
    - `answered_by` 'human' | 'machine' | 'voicemail' | 'live_voicemail' | 'screening' | 'ivr' | 'music' | 'human_gatekeeper' | 'sit_invalid' | 'fax' | 'silence' | 'unknown': PyAI's richer answered-by vocabulary. `machine` means an automated answer without an established subtype; it does not establish voicemail readiness or authorize hanging up. `screening` = an iPhone/Google call-screening assistant; `sit_invalid` = a dead/disconnected number.
    - `answered_by_twilio` string, nullable: Twilio's exact `AnsweredBy` enum (human | machine_start | machine_end_beep | machine_end_silence | machine_end_other | fax | unknown), so a Twilio drop-in keeps its routing logic unchanged.
    - `confidence` number, nullable
    - `decision_ms` number, nullable: Processed inbound audio through the decision, in ms; not elapsed time from carrier answer.
    - `created_at` integer: Unix ms when the decision was written.
  - `has_more` boolean
  - `next_cursor` string, nullable

## Other responses

- `401`: Missing or invalid API key (`code: unauthorized`)

---

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