## List

**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.

### Query Parameters

- `page: number`

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

- `page_size: number`

  The number of calls to return per page.

- `statuses: optional array of "initializing" or "queued_for_calling" or "calling" or 4 more`

  - `"initializing"`

  - `"queued_for_calling"`

  - `"calling"`

  - `"scheduled"`

  - `"completed"`

  - `"cancelled"`

  - `"errored"`

### Returns

- `calls: array of object { id, answered_at, dial_error, 10 more }`

  - `id: string`

    The ID of the call attempt.

  - `answered_at: unknown`

    The time the call was answered.

  - `dial_error: "number_non_attributed" or "too_many_calls" or "busy" or 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: unknown`

    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" or "voicemail" or "human" or 2 more`

    - `"IVR"`

    - `"voicemail"`

    - `"human"`

    - `"unknown"`

    - `"ios-screening-filter"`

  - `started_at: unknown`

    The time the call started.

  - `status: "queued" or "ringing" or "ongoing" or 2 more`

    The status of the call attempt.

    - `"queued"`

    - `"ringing"`

    - `"ongoing"`

    - `"completed"`

    - `"error"`

  - `end_reason: optional string`

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

  - `ended_by: optional "agent" or "user" or "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 map[unknown]`

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

  - `transcript: optional array of object { content, role, tool_arguments, 2 more }`

    The transcript of the call.

    - `content: string`

    - `role: "user" or "assistant" or "tool"`

      - `"user"`

      - `"assistant"`

      - `"tool"`

    - `tool_arguments: optional map[unknown] or string`

      - `UnionMember0 = map[unknown]`

      - `UnionMember1 = string`

    - `tool_is_error: optional boolean`

    - `tool_name: optional string`

### Example

```http
curl https://www.getrevox.com/api/call \
    -H "Authorization: Bearer $REVOX_API_KEY"
```