## List

`call.list(CallListParams**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: int`

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

- `page_size: int`

  The number of calls to return per page.

- `statuses: Optional[List[Literal["initializing", "queued_for_calling", "calling", 4 more]]]`

  - `"initializing"`

  - `"queued_for_calling"`

  - `"calling"`

  - `"scheduled"`

  - `"completed"`

  - `"cancelled"`

  - `"errored"`

### Returns

- `class CallListResponse: …`

  - `calls: List[Call]`

    - `id: str`

      The ID of the call attempt.

    - `answered_at: object`

      The time the call was answered.

    - `dial_error: Optional[Literal["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: object`

      The time the call ended.

    - `phone_number: str`

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

    - `recording_url: Optional[str]`

      The URL of the audio recording of the call.

    - `result: Optional[Literal["IVR", "voicemail", "human", 2 more]]`

      - `"IVR"`

      - `"voicemail"`

      - `"human"`

      - `"unknown"`

      - `"ios-screening-filter"`

    - `started_at: object`

      The time the call started.

    - `status: Literal["queued", "ringing", "ongoing", 2 more]`

      The status of the call attempt.

      - `"queued"`

      - `"ringing"`

      - `"ongoing"`

      - `"completed"`

      - `"error"`

    - `end_reason: Optional[str]`

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

    - `ended_by: Optional[Literal["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: Optional[Dict[str, object]]`

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

    - `transcript: Optional[List[CallTranscript]]`

      The transcript of the call.

      - `content: str`

      - `role: Literal["user", "assistant", "tool"]`

        - `"user"`

        - `"assistant"`

        - `"tool"`

      - `tool_arguments: Optional[Union[Dict[str, object], str, null]]`

        - `Dict[str, object]`

        - `str`

      - `tool_is_error: Optional[bool]`

      - `tool_name: Optional[str]`

### Example

```python
import os
from revox import Revox

client = Revox(
    api_key=os.environ.get("REVOX_API_KEY"),  # This is the default and can be omitted
)
calls = client.call.list(
    page=1,
    page_size=1,
)
print(calls.calls)
```