> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vozagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Calls

> Retrieve a list of all calls.

<Note>
  Retrieve your API Key from your [VozAgent Dashboard](https://app.vozagent.ai/settings/api).
</Note>

## Query parameters

<ParamField query="limit" type="number" default="50">
  Maximum number of calls to return. Range: 0-100.
</ParamField>

<ParamField query="offset" type="number">
  Pagination offset.
</ParamField>

<ParamField query="status" type="string">
  Filter by status: `completed`, `in-progress`, `failed`.
</ParamField>

<ParamField query="contact_id" type="string">
  Filter calls by contact ID.
</ParamField>

<ParamField query="assistant_id" type="string">
  Filter calls by assistant ID.
</ParamField>

<ParamField query="call_type" type="string">
  Filter by type: `inbound` or `outbound`.
</ParamField>

## Response

Returns an array of call records with summary information.

<ResponseField name="id" type="string">
  Unique call identifier.
</ResponseField>

<ResponseField name="contact_id" type="string">
  Associated contact ID.
</ResponseField>

<ResponseField name="assistant_id" type="string">
  Assistant that handled the call.
</ResponseField>

<ResponseField name="call_type" type="string">
  `inbound` or `outbound`.
</ResponseField>

<ResponseField name="call_status" type="string">
  Current status of the call.
</ResponseField>

<ResponseField name="duration_seconds" type="number">
  Call duration in seconds.
</ResponseField>

<ResponseField name="appointment_booked" type="boolean">
  Whether an appointment was booked.
</ResponseField>

<ResponseField name="lead_qualification" type="string">
  Lead score: `hot`, `warm`, or `cold`.
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl https://api.vozagent.ai/v1/calls \
    -H "Authorization: Bearer <token>"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  [
    {
      "id": "call-a1b2c3d4-e5f6-a7b8-c9d0",
      "contact_id": "c1a2b3c4-d5e6-f7a8-b9c0",
      "assistant_id": "a1b2c3d4-e5f6-a7b8",
      "call_type": "inbound",
      "call_status": "completed",
      "duration_seconds": 180,
      "call_started_at": "2024-01-15T10:30:00Z",
      "call_ended_at": "2024-01-15T10:33:00Z",
      "appointment_booked": true,
      "lead_qualification": "hot",
      "call_intent": "new_quote"
    },
    {
      "id": "call-b2c3d4e5-f6a7-b8c9-d0e1",
      "contact_id": "d2b3c4d5-e6f7-a8b9-c0d1",
      "assistant_id": "a1b2c3d4-e5f6-a7b8",
      "call_type": "outbound",
      "call_status": "completed",
      "duration_seconds": 95,
      "call_started_at": "2024-01-15T11:00:00Z",
      "call_ended_at": "2024-01-15T11:01:35Z",
      "appointment_booked": false,
      "lead_qualification": "warm"
    }
  ]
  ```
</ResponseExample>