---
title: "List Agent Calls"
method: GET
path: "/api/v1/phone/calls"
tags: ["Phone Calls"]
---

# List Agent Calls

`GET /api/v1/phone/calls`

## Query parameters

- `agent_identity_id` string, uuid, nullable — Agent identity to list calls for. Agent-scoped keys resolve their own; required for admin/JWT.
- `limit` integer
- `offset` integer
- `is_blocked` boolean, nullable
- `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'
  - `reason` string, nullable
  - `post_call_action_items` PostCallActionResponse[]
    - `id` string, uuid, required
    - `seq` integer, required
    - `action` string, required
    - `details` string, nullable
    - `status` 'open' | 'canceled'
  - `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'
  - `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.

---

[API](https://skmtc.dev/inkbox/apis/inkbox-api.md) · [All operations](https://skmtc.dev/inkbox/apis/inkbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/inkbox/inkbox-api/revisions/31f357e7e6f8/schema)