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

# List conversations

> List conversations, optionally filtered by agent or user

<ParamField query="agent_id" type="integer">
  Restrict results to one agent.
</ParamField>

<ParamField query="external_user_id" type="string">
  Restrict results to one end user.
</ParamField>

<ResponseField name="data" type="ConversationSummary[]" required>
  Page of conversation summaries (`id`, `external_user_id`).
</ResponseField>

## SDK

<CodeGroup>
  ```typescript TypeScript theme={null}
  const page = await client.conversations.list({ agent_id: 7 });
  ```

  ```python Python theme={null}
  page = await client.conversations.list(agent_id=7)
  ```
</CodeGroup>