> ## 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 Assistants

> Retrieve a list of all assistants.

<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 assistants to return. Range: 0-100.
</ParamField>

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

<ParamField query="is_active" type="boolean">
  Filter by active status.
</ParamField>

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

## Response

Returns an array of assistant objects with their configuration details.

<ResponseField name="id" type="string">
  Unique identifier for the assistant.
</ResponseField>

<ResponseField name="name" type="string">
  Display name of the assistant.
</ResponseField>

<ResponseField name="role" type="string">
  The role/persona of the assistant.
</ResponseField>

<ResponseField name="assistant_type" type="string">
  Type: `inbound`, `outbound`, or `custom`.
</ResponseField>

<ResponseField name="is_active" type="boolean">
  Whether the assistant is currently active.
</ResponseField>

<ResponseField name="voice_id" type="string">
  Voice model being used.
</ResponseField>

<ResponseField name="first_message" type="string">
  Initial greeting message.
</ResponseField>

<ResponseField name="phone_number_id" type="string">
  Linked phone number ID (if any).
</ResponseField>

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

<ResponseExample>
  ```json theme={null}
  [
    {
      "id": "a1b2c3d4-e5f6-a7b8-c9d0-e1f2a3b4c5d6",
      "name": "Inbound Receptionist",
      "role": "receptionist",
      "assistant_type": "inbound",
      "is_active": true,
      "voice_id": "sarah",
      "first_message": "Hello! Thanks for calling...",
      "phone_number_id": "pn1234",
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z"
    },
    {
      "id": "b2c3d4e5-f6a7-b8c9-d0e1-f2a3b4c5d6e7",
      "name": "Follow-up Agent",
      "role": "sales",
      "assistant_type": "outbound",
      "is_active": true,
      "voice_id": "marcus",
      "created_at": "2024-01-14T14:20:00Z",
      "updated_at": "2024-01-14T14:20:00Z"
    }
  ]
  ```
</ResponseExample>