---
title: "List conversations"
method: GET
path: "/ai/conversations"
tags: ["Conversations"]
---

# List conversations

`GET /ai/conversations`

Retrieve a list of all AI conversations configured by the user. Supports [PostgREST-style query parameters](https://postgrest.org/en/stable/api.html#horizontal-filtering-rows) for filtering. Examples are included for the standard metadata fields, but you can filter on any field in the metadata JSON object. For example, to filter by a custom field `metadata->custom_field`, use `metadata->custom_field=eq.value`.

## Query parameters

- `id` string
- `name` string
- `created_at` string
- `last_message_at` string
- `metadata->assistant_id` string
- `metadata->call_control_id` string
- `metadata->telnyx_agent_target` string
- `metadata->telnyx_end_user_target` string
- `metadata->telnyx_conversation_channel` string
- `limit` integer
- `order` string
- `or` string

## Response `200`

Successful Response

- ConversationsListData
  - `data` Conversation[], required
    - `id` string, uuid, required
    - `name` string
    - `created_at` string, date-time, required — The datetime the conversation was created.
    - `metadata` object, required — Metadata associated with the conversation. Telnyx provides several pieces of metadata, but customers can also add their own. The reserved field `ai_disabled` (boolean) can be set to `true` to prevent AI-generated responses on this conversation. When `ai_disabled` is `true`, calls to the chat endpoint will return a 400 error. Set to `false` or remove the field to re-enable AI responses. This is useful when a human agent needs to take over the conversation mid-stream (e.g., a technician stepping in while AI was messaging a resident).
    - `last_message_at` string, date-time, required — The datetime of the latest message in the conversation.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/versions/e32d46c5945b/schema)