---
title: "List Calls"
method: GET
path: "/api/v1/phone/numbers/{phone_number_id}/calls"
tags: ["Phone Calls"]
deprecated: true
---

# List Calls

`GET /api/v1/phone/numbers/{phone_number_id}/calls`

## Request

- Base URL: `https://api.inkbox.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.inkbox.ai/api/v1/phone/numbers/{phone_number_id}/calls`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

> **Deprecated.**

## Path parameters

- `phone_number_id` string, uuid, required

## Query parameters

- `limit` integer
- `offset` integer
- `is_blocked` boolean, nullable: Filter by blocked state: true for only blocked, false for only non-blocked, omit for all. Agent-scoped callers never see blocked rows regardless of this filter (enforced at the access-policy layer).
- `start_datetime` string, nullable: Filter created_at >= this date/datetime. Bare date => whole day in tz.
- `end_datetime` string, nullable: Filter created_at <= this date/datetime. Bare date => whole day inclusive.
- `tz` string, nullable: IANA zone (e.g. America/New_York) for zone-less values; default UTC.

## Response `200`

Successful Response

- PhoneCallResponse[]
  - `id` string, uuid, required
  - `origin` 'dedicated_number' | 'shared_imessage_number' | 'dedicated_imessage_number'
  - `local_phone_number` string, nullable
  - `remote_phone_number` string, required
  - `direction` 'outbound' | 'inbound', required
  - `status` 'initiated' | 'ringing' | 'answered' | 'completed' | 'failed' | 'canceled', required
  - `client_websocket_url` string, nullable, required
  - `mode` 'client_websocket' | 'hosted_agent'
  - `hosted_agent_authority_mode` 'contact_scoped' | 'yolo'
  - `voicemail_detection` 'enabled' | 'disabled'
  - `on_voicemail` 'hang_up' | 'leave_message' | 'ignore'
  - `reason` string, nullable
  - `post_call_action_items` PostCallActionResponse[]
    - `id` string, uuid, required
    - `seq` integer, required
    - `action` string, required
    - `details` string, nullable
    - `status` 'open' | 'canceled'
  - `connections` PhoneCallConnectionResponse[]
    - `id` string, uuid, required
    - `kind` 'handoff' | 'conference', required
    - `trigger` 'incoming_action' | 'agent_tool', required
    - `status` 'requested' | 'dialing' | 'connected' | 'failed', required
    - `target_type` 'phone' | 'sip', required
    - `target` string, required
    - `requested_at` string, date-time, required
    - `dialing_at` string, date-time, nullable
    - `connected_at` string, date-time, nullable
    - `ended_at` string, date-time, nullable
    - `failure_code` string, nullable
  - `forwardings` PhoneCallForwardingResponse[]
    - `id` string, uuid, required
    - `trigger` 'incoming_action', required
    - `status` 'requested' | 'dialing' | 'forwarded' | 'failed', required
    - `target_type` 'phone' | 'sip', required
    - `target` string, required
    - `requested_at` string, date-time, required
    - `dialing_at` string, date-time, nullable
    - `forwarded_at` string, date-time, nullable
    - `ended_at` string, date-time, nullable
    - `failure_code` string, nullable
  - `use_inkbox_tts` boolean, nullable, required
  - `use_inkbox_stt` boolean, nullable, required
  - `hangup_reason` 'local' | 'remote' | 'max_duration' | 'voicemail' | 'rejected' | 'failed' | 'no_answer' | 'missed' | 'busy' | 'dropped'
  - `ended_by` 'local' | 'remote' | 'unknown'
  - `provider_hangup_cause` string, nullable
  - `started_at` string, date-time, nullable, required
  - `ended_at` string, date-time, nullable, required
  - `is_blocked` boolean
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error
- `4XX`: Client error with Support Agent information.
- `5XX`: Server error with Support Agent information.

## Changes

- **2026-10-12** `f89b69e22318`: 1 info
  - added the optional property `items/connections` to the response with the `200` status
- **2026-09-20** `4e8dd191442e`: 1 info
  - added the optional property `items/on_voicemail` to the response with the `200` status
- **2026-09-08** `860d39e7cc99`: 4 warning, 2 info
  - added the new `busy` enum value to the `items/hangup_reason/anyOf[subschema #1: HangupReason]/` response property for the response status `200`
  - added the new `dropped` enum value to the `items/hangup_reason/anyOf[subschema #1: HangupReason]/` response property for the response status `200`
  - added the new `missed` enum value to the `items/hangup_reason/anyOf[subschema #1: HangupReason]/` response property for the response status `200`
  - added the new `no_answer` enum value to the `items/hangup_reason/anyOf[subschema #1: HangupReason]/` response property for the response status `200`
  - …2 more

[Operation history](https://skmtc.dev/inkbox/apis/inkbox-api/changes/api/v1/phone/numbers/:phone_number_id/calls/get.md)

---

[API](https://skmtc.dev/inkbox/apis/inkbox-api.md) - [All operations](https://skmtc.dev/inkbox/apis/inkbox-api/llms.txt) - [OpenAPI document](https://skmtc.dev/inkbox/apis/inkbox-api/revisions/3e862146bf53?raw)