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

# List assistants

> Retrieve all AI assistants for your account with pagination.

Returns a paginated list of all AI assistants belonging to the authenticated user.

## Endpoint

`GET /user/assistants/get`

## Query parameters

<ParamField query="per_page" type="integer">
  Number of assistants per page. Range: 1–100. Default: `10`.
</ParamField>

<ParamField query="page" type="integer">
  Page number. Default: `1`.
</ParamField>

## Response

<ResponseField name="data" type="array">
  Array of assistant objects.

  <Expandable title="Assistant properties">
    <ResponseField name="id" type="integer">
      Unique identifier of the assistant.
    </ResponseField>

    <ResponseField name="user_id" type="integer">
      ID of the user who owns this assistant.
    </ResponseField>

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

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

    <ResponseField name="mode" type="string">
      Engine mode: `pipeline`, `multimodal`, or `dualplex`.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current status: `active` or `inactive`.
    </ResponseField>

    <ResponseField name="initial_message" type="string">
      The greeting message spoken at the start of a call.
    </ResponseField>

    <ResponseField name="system_prompt" type="string">
      System prompt that defines the assistant's behavior.
    </ResponseField>

    <ResponseField name="voice_id" type="integer">
      ID of the voice used by the assistant.
    </ResponseField>

    <ResponseField name="language_id" type="integer">
      ID of the primary language.
    </ResponseField>

    <ResponseField name="phone_number_id" type="integer">
      ID of the phone number assigned to the assistant.
    </ResponseField>

    <ResponseField name="timezone" type="string">
      Timezone setting (e.g., `America/New_York`).
    </ResponseField>

    <ResponseField name="max_duration" type="integer">
      Maximum call duration in seconds.
    </ResponseField>

    <ResponseField name="record" type="boolean">
      Whether calls are recorded.
    </ResponseField>

    <ResponseField name="allow_interruptions" type="boolean">
      Whether caller interruptions are allowed.
    </ResponseField>

    <ResponseField name="enable_noise_cancellation" type="boolean">
      Whether noise cancellation is enabled.
    </ResponseField>

    <ResponseField name="wait_for_customer" type="boolean">
      Whether the assistant waits for the customer to speak first.
    </ResponseField>

    <ResponseField name="end_call_on_voicemail" type="integer">
      Whether to end the call on voicemail detection. `1` = yes, `0` = no.
    </ResponseField>

    <ResponseField name="post_call_evaluation" type="boolean">
      Whether post-call AI evaluation is enabled.
    </ResponseField>

    <ResponseField name="post_call_schema" type="array">
      Schema for post-call data extraction fields.

      <Expandable title="Schema field properties">
        <ResponseField name="name" type="string">Field name.</ResponseField>
        <ResponseField name="type" type="string">Data type: `string`, `number`, or `bool`.</ResponseField>
        <ResponseField name="description" type="string">Description of the field.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="variables" type="object">
      Custom variables defined for the assistant.
    </ResponseField>

    <ResponseField name="tools" type="array">
      Built-in tools enabled on the assistant.
    </ResponseField>

    <ResponseField name="is_webhook_active" type="boolean">
      Whether post-call webhook notifications are enabled.
    </ResponseField>

    <ResponseField name="webhook_url" type="string">
      Webhook URL for post-call notifications.
    </ResponseField>

    <ResponseField name="inbound_webhook_url" type="string">
      Webhook URL for inbound call notifications.
    </ResponseField>

    <ResponseField name="knowledgebase_id" type="integer">
      ID of the attached knowledge base.
    </ResponseField>

    <ResponseField name="knowledgebase_mode" type="string">
      Knowledge base mode: `function_call` or `prompt`.
    </ResponseField>

    <ResponseField name="llm_model_id" type="integer">
      ID of the LLM model used (pipeline mode).
    </ResponseField>

    <ResponseField name="multimodal_model_id" type="integer">
      ID of the multimodal model used (multimodal/dualplex modes).
    </ResponseField>

    <ResponseField name="llm_temperature" type="string">
      LLM temperature setting.
    </ResponseField>

    <ResponseField name="voice_stability" type="string">
      Voice stability setting.
    </ResponseField>

    <ResponseField name="voice_similarity" type="string">
      Voice similarity setting.
    </ResponseField>

    <ResponseField name="speech_speed" type="string">
      Speech speed multiplier.
    </ResponseField>

    <ResponseField name="endpoint_type" type="string">
      Voice activity detection type: `vad` or `ai`.
    </ResponseField>

    <ResponseField name="endpoint_sensitivity" type="number">
      Endpoint sensitivity level.
    </ResponseField>

    <ResponseField name="interrupt_sensitivity" type="number">
      Interrupt sensitivity level.
    </ResponseField>

    <ResponseField name="max_silence_duration" type="integer">
      Maximum silence duration in seconds before re-engagement.
    </ResponseField>

    <ResponseField name="reengagement_interval" type="integer">
      Re-engagement interval in seconds.
    </ResponseField>

    <ResponseField name="ambient_sound" type="string">
      Ambient background sound setting.
    </ResponseField>

    <ResponseField name="ambient_sound_volume" type="string">
      Ambient sound volume level.
    </ResponseField>

    <ResponseField name="fillers" type="integer">
      Whether filler audio is enabled. `1` = enabled, `0` = disabled.
    </ResponseField>

    <ResponseField name="filler_config" type="object">
      Filler audio configuration by response category.
    </ResponseField>

    <ResponseField name="uuid" type="string">
      Unique UUID for the assistant.
    </ResponseField>

    <ResponseField name="send_webhook_only_on_completed" type="boolean">
      Whether webhooks are only sent for completed calls.
    </ResponseField>

    <ResponseField name="include_recording_in_webhook" type="boolean">
      Whether the recording URL is included in webhook payloads.
    </ResponseField>

    <ResponseField name="min_interrupt_words" type="integer">
      Minimum number of words required before an interruption is processed.
    </ResponseField>

    <ResponseField name="widget_settings" type="object">
      Web widget integration settings.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp when the assistant was created.
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp when the assistant was last updated.
    </ResponseField>

    <ResponseField name="deleted_at" type="string">
      Soft deletion timestamp. `null` if not deleted.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="current_page" type="integer">
  Current page number.
</ResponseField>

<ResponseField name="per_page" type="integer">
  Number of items per page.
</ResponseField>

<ResponseField name="total" type="integer">
  Total number of assistants.
</ResponseField>

<ResponseField name="last_page" type="integer">
  Last page number.
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://portal.intellixent.ai/api/user/assistants/get?per_page=10&page=1" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://portal.intellixent.ai/api/user/assistants/get?per_page=10&page=1',
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    }
  );

  const data = await response.json();
  console.log(data.data); // Array of assistants
  ```
</CodeGroup>

## Response example

```json theme={null}
{
  "current_page": 1,
  "data": [
    {
      "id": 127,
      "user_id": 1,
      "name": "Sales Outreach Assistant",
      "type": "outbound",
      "mode": "pipeline",
      "status": "active",
      "initial_message": "Hi, this is an assistant from Your Company. How are you doing today?",
      "system_prompt": "You are a sales representative for Your Company...",
      "voice_id": 8,
      "language_id": 1,
      "phone_number_id": 45,
      "timezone": "America/Los_Angeles",
      "max_duration": 900,
      "record": true,
      "uuid": "a7b3c942-5f1e-4d28-8c59-2e4f7a8b9c3d",
      "created_at": "2025-07-15T14:32:15.000000Z",
      "updated_at": "2025-08-02T09:18:42.000000Z"
    }
  ],
  "per_page": 10,
  "total": 47,
  "last_page": 5
}
```
