---
title: "Retrieve a list of Conversations"
method: GET
path: "/v3/Conversations"
tags: ["Conversations"]
---

# Retrieve a list of Conversations

`GET /v3/Conversations`

Retrieve a list of Conversations processed by an Intelligence Configuration.

## Query parameters

- `pageSize` integer
- `pageToken` string
- `createdAtBefore` string, date-time
- `createdAtAfter` string, date-time
- `status` 'ACTIVE' | 'INACTIVE' | 'CLOSED' — The status of the Conversation.
- `channelId` string
- `channels` string[]
- `conversationConfigurationId` string — The `id` of the Configuration for a Conversation.
- `intelligenceConfigurationIds` string[]
- `operatorIds` string[]

## Response `200`

An array of Conversations.

- object
  - `items` ConversationListItem[], required — List of conversations.
    - `id` string, required — The `id` of the Conversation attached to the Operator Result.
    - `accountId` string, nullable, required — The ID of the account that owns the Conversation.
    - `name` string, nullable, required — Display name of the Conversation.
    - `status` 'ACTIVE' | 'INACTIVE' | 'CLOSED', required — The status of the Conversation.
    - `createdAt` string, date-time, required — Timestamp for when the Conversation was created.
    - `updatedAt` string, date-time, required — Timestamp for when the Conversation was last updated.
    - `intelligenceConfigurationIds` IntelligenceConfigurationTtid[], required — The Intelligence Configuration(s) associated with the Conversation.
    - `conversationConfigurationId` string, required — The `id` of the Configuration for a Conversation.
    - `channels` Channel[], required — The communication channel(s) included in the Conversation.
    - `channelIds` string[], required — The underlying channel resource `id`s associated with this Conversation, such as a Call ID or Message ID.
    - `participants` Participant[], required — Metadata for Participants of the Conversation.
      - `id` string, required — The `id` of the Participant in the Conversation.
      - `name` string, nullable — Participant display name.
      - `type` string, nullable — Type of participant in the conversation. Available types: - `CUSTOMER` - `HUMAN_AGENT` - `AI_AGENT` - `AGENT` - `UNKNOWN`
      - `addressValues` string[], required — Participant address values (for example, a phone number or sender identifier).
    - `operatorResultIds` string[], required — List of Operator Result IDs generated from this Conversation.
  - `meta` object, required
    - `key` string, required — A key, sibling to the `meta` object that holds the actual list of resources
    - `pageSize` integer, required — The actual number of resources returned in the response
    - `previousToken` string
    - `nextToken` string

## Other responses

- `400` — Bad request
- `401` — Unauthorized request
- `403` — Forbidden request
- `404` — Resource not found
- `429` — Too Many requests (rate limit exceeded for request originating from public API)
- `500` — Internal server error

---

[API](https://skmtc.net/twilio/apis/twilio-intelligence.md) · [All operations](https://skmtc.net/twilio/apis/twilio-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/twilio-intelligence/revisions/3a830979326d/schema)