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

# List Conversations

`GET /core/conversations`

## Request

- Base URL: `https://api.anyreach.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.anyreach.ai/core/conversations`
- Auth: HTTP bearer

List all conversations.

## Query parameters

- `direction` string, nullable
- `user_id` string, nullable
- `agent_number` string, nullable
- `agent_id` string, nullable
- `agent_version_id` string, nullable
- `web_widget_id` string, nullable
- `trunk_id` string, nullable
- `experiment_id` string, nullable
- `experiment_variant` string, nullable
- `channel` string, nullable
- `duration_above` integer, nullable
- `duration_below` integer, nullable
- `user_turn_count_above` integer, nullable
- `user_turn_count_below` integer, nullable
- `service_version` string, nullable
- `custom_metadata` string, nullable
- `status` string, nullable
- `created_after` string, date-time, nullable
- `created_before` string, date-time, nullable
- `updated_after` string, date-time, nullable
- `updated_before` string, date-time, nullable
- `limit` integer, nullable
- `cursor` string, nullable
- `columns` string, nullable

## Headers

- `x-anyreach-org` string, nullable: Organization ID for user PATs (pat_ prefix tokens)

## Response `200`

Successful Response

- ConversationPartial[]
  - `id` string, nullable
  - `organization_id` string, nullable
  - `trunk_id` string, nullable
  - `trunk_config` object, nullable
  - `direction` 'inbound' | 'outbound': Direction of the conversation.
  - `agent_id` string, nullable
  - `agent_version_id` string, nullable
  - `web_widget_id` string, nullable
  - `agent_config` unknown
  - `user_id` string, nullable
  - `agent_number` string, nullable
  - `channel` 'telephone' | 'webrtc' | 'email' | 'text' | 'webchat': Channel type for the conversation.
  - `duration` integer, nullable
  - `user_turn_count` integer, nullable
  - `user_name` string
  - `recording_details` RecordingDetailResponse: API-safe view of RecordingDetail, which holds storage credentials.
    - `egress_id` string, nullable
    - `filepath` string, nullable
    - `recording_url` string, nullable
  - `custom_metadata` object, nullable
  - `system_metadata` object, nullable
  - `conversation` object, nullable
  - `sip` object, nullable
  - `initial_context` string
  - `summary` string
  - `status` 'token_created' | 'triggered' | 'ringing' | 'in_progress' | 'completed' | 'failed' | 'cancelled' | 'transferred' | 'unanswered': Status of the conversation.
  - `service_version` string, nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `created_by` string, nullable
  - `modified_by` string, nullable
  - `extracted_data` ExtractedData: The column's contract. Unknown top-level keys are ignored, and attribute values are read as stored: guardrails apply on write, so a value outside them never fails a read.
    - `schema_version` integer
    - `topics` TopicAssignment[]
      - `id` string, required
      - `name` string, nullable
      - `path` string, nullable
      - `trigger` string, nullable
      - `assigned_at` string, nullable
      - `applied_to_helpdesk` boolean
    - `attributes` object
    - `attribute_sources` object
    - `updated_at` string, nullable
  - `experiment_id` string, nullable
  - `experiment_variant` string, nullable
  - `agent` ConversationAgent: Agent reference with id and name.
    - `id` string, required
    - `name` string, required
    - `version` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/anyreach/apis/anyreach-api.md) - [All operations](https://skmtc.dev/anyreach/apis/anyreach-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anyreach/apis/anyreach-api/revisions/2eddf40c8c93?raw)