---
title: "List Calls"
method: GET
path: "/v1/calls/list"
tags: ["calls"]
---

# List Calls

`GET /v1/calls/list`

## Query parameters

- `page` integer
- `size` integer
- `sort_column` string, nullable
- `sort_desc` boolean, nullable

## Response `200`

Successful Response

- CallPage
  - `items` NormalizedCall[], required
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `status` 'not_started' | 'in_progress' | 'error' | 'ended'
    - `error_message` string, nullable
    - `recording_available` boolean
    - `transcript` string, nullable
    - `human_detection_result` 'human' | 'no_human', nullable
    - `do_not_call_result` boolean, nullable
    - `telephony_id` string, nullable
    - `stage` 'created' | 'picked_up' | 'transfer_started' | 'transfer_successful', nullable
    - `stage_outcome` 'human_unanswered' | 'call_did_not_connect' | 'human_disconnected' | 'bot_disconnected' | 'transfer_unanswered' | 'transfer_disconnected', nullable
    - `telephony_metadata` union
      - VonageTelephonyMetadata
        - `type` 'telephony_metadata_vonage'
      - TwilioTelephonyMetadata
        - `type` 'telephony_metadata_twilio'
        - `call_sid` string, nullable
        - `call_status` string, nullable
        - `transfer_call_sid` string, nullable
        - `transfer_call_status` string, nullable
        - `conference_sid` string, nullable
    - `start_time` number, nullable
    - `end_time` number, nullable
    - `to_number` string, required
    - `from_number` string, required
    - `agent` string, uuid, required
    - `telephony_provider` 'vonage' | 'twilio', required
    - `agent_phone_number` string, required
    - `hipaa_compliant` boolean
    - `on_no_human_answer` 'continue' | 'hangup', nullable
    - `context` object, nullable
    - `run_do_not_call_detection` boolean, nullable
    - `telephony_account_connection` union
      - string, uuid
      - TwilioAccountConnection
        - `id` string, uuid, required
        - `user_id` string, uuid, required
        - `credentials` TwilioCredentials, required
          - `twilio_account_sid` string, required
          - `twilio_auth_token` string, required
        - `type` 'account_connection_twilio', required
        - `steering_pool` string[]
        - `account_supports_any_caller_id` boolean
    - `telephony_params` object, nullable
  - `page` integer, required
  - `size` integer, required
  - `has_more` boolean, required
  - `total` integer, required
  - `total_is_estimated` boolean, required

## Other responses

- `422` — Validation Error

## Changes

- **2024-08-14** `63991d99e2e1` — 13 breaking, 22 info
  - response property `items/items/context` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/do_not_call_result` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/end_time` list-of-types was widened by adding types `null and number` to media type `application/json` of response `200`
  - response property `items/items/error_message` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …31 more
- **2024-04-19** `55ae0e0bb01f` — 3 info
  - added the optional property `items/items/telephony_metadata` to the response with the `200` status
  - added the required property `total` to the response with the `200` status
  - added the required property `total_is_estimated` to the response with the `200` status
- **2024-04-15** `47ab17602d64` — 2 info
  - added the optional property `items/items/telephony_account_connection/anyOf[subschema #2: TwilioAccountConnection]/account_supports_any_caller_id` to the response with the `200` status
  - added the optional property `items/items/telephony_account_connection/anyOf[subschema #2: TwilioAccountConnection]/steering_pool` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/changes/v1/calls/list/get.md)

---

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