---
title: "List all assistants"
method: GET
path: "/v1/Assistants"
---

# List all assistants

`GET /v1/Assistants`

## Request

- Base URL: `https://assistants.twilio.com`
- URL: `https://assistants.twilio.com/v1/Assistants`
- Auth: HTTP basic

list assistants

## Query parameters

- `Page` integer
- `PageSize` integer
- `PageToken` string

## Response `200`

OK

- object
  - `assistants` AssistantsV1ServiceAssistant[]
    - `account_sid` string, required: The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Assistant resource.
    - `customer_ai` object, required: The Personalization and Perception Engine settings.
    - `id` string, required: The Assistant ID.
    - `model` string, required: The default model used by the assistant.
    - `name` string, required: The name of the assistant.
    - `owner` string, required: The owner/company of the assistant.
    - `url` string: The url of the assistant resource.
    - `personality_prompt` string, required: The personality prompt to be used for assistant.
    - `date_created` string, date-time, required: The date and time in GMT when the Assistant was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `date_updated` string, date-time, required: The date and time in GMT when the Assistant was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `meta` object
    - `first_page_url` string, uri
    - `key` string
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri

## Changes

- **2025-05-13** (v1) `0852198458a0`: 1 info
  - the `assistants/items/id` response's property pattern was changed from `^aia_asst_*$` to `^aia_asst_.+$` for the status `200`
- **2024-09-25** (v1) `1ad87f675d4b`: 2 info
  - api operation id `ListAssistant` removed and replaced with `ListAssistants`
  - added the optional property `assistants/items/url` to the response with the `200` status

[Operation history](https://skmtc.dev/twilio/apis/assistants-v1/changes/v1/Assistants/get.md)

---

[API](https://skmtc.dev/twilio/apis/assistants-v1.md) - [All operations](https://skmtc.dev/twilio/apis/assistants-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/assistants-v1/revisions/c5ec7f024ee9?raw)