## List

`call.list(**kwargs) -> CallListResponse`

**get** `/call`

Retrieve a paginated list of call attempts. Each entry includes the call status, phone number, assistant used, transcript, and timestamps. Use the page and page_size query parameters to navigate through results.

### Parameters

- `page: Integer`

  The page number you want to get. Starting at 0.

- `page_size: Integer`

  The number of calls to return per page.

- `statuses: Array[:initializing | :queued_for_calling | :calling | 4 more]`

  - `:initializing`

  - `:queued_for_calling`

  - `:calling`

  - `:scheduled`

  - `:completed`

  - `:cancelled`

  - `:errored`

### Returns

- `class CallListResponse`

  - `calls: Array[{ id, answered_at, dial_error, 10 more}]`

    - `id: String`

      The ID of the call attempt.

    - `answered_at: untyped`

      The time the call was answered.

    - `dial_error: :number_non_attributed | :too_many_calls | :busy | 5 more`

      The SIP error that occurred.

      - `:number_non_attributed`

      - `:too_many_calls`

      - `:busy`

      - `:temporarily_unavailable`

      - `:no_answer`

      - `:no_international_permission`

      - `:precondition_failed`

      - `:non_classified_error`

    - `ended_at: untyped`

      The time the call ended.

    - `phone_number: String`

      The phone number that was called. Formatted in E.164 format. Example: +1234567890

    - `recording_url: String`

      The URL of the audio recording of the call.

    - `result: :IVR | :voicemail | :human | 2 more`

      - `:IVR`

      - `:voicemail`

      - `:human`

      - `:unknown`

      - `:"ios-screening-filter"`

    - `started_at: untyped`

      The time the call started.

    - `status: :queued | :ringing | :ongoing | 2 more`

      The status of the call attempt.

      - `:queued`

      - `:ringing`

      - `:ongoing`

      - `:completed`

      - `:error`

    - `end_reason: String`

      Reason for ending the call when ended_by is 'agent'. E.g. 'tool_end_call', 'voicemail', 'transfer', 'ivr_no_navigate'.

    - `ended_by: :agent | :user | :system`

      Who ended the call: 'agent' (AI agent), 'user' (caller/callee hung up), or 'system' (e.g. max duration limit).

      - `:agent`

      - `:user`

      - `:system`

    - `structured_output: Hash[Symbol, untyped]`

      The data extracted from the call, using the structured output config from the parent call object.

    - `transcript: Array[{ content, role, tool_arguments, 2 more}]`

      The transcript of the call.

      - `content: String`

      - `role: :user | :assistant | :tool`

        - `:user`

        - `:assistant`

        - `:tool`

      - `tool_arguments: Hash[Symbol, untyped] | String`

        - `Hash[Symbol, untyped]`

        - `String`

      - `tool_is_error: bool`

      - `tool_name: String`

### Example

```ruby
require "revox"

revox = Revox::Client.new(api_key: "My API Key")

calls = revox.call.list(page: 1, page_size: 1)

puts(calls)
```