---
title: "GET /v1/{account_id}/{project_id}/conversations"
method: GET
path: "/v1/{account_id}/{project_id}/conversations"
---

# GET /v1/{account_id}/{project_id}/conversations

`GET /v1/{account_id}/{project_id}/conversations`

Returns all conversations matching filters.

## Path parameters

- `account_id` string, required
- `project_id` string, required

## Query parameters

- `client_env` 'sandbox' | 'pre-release' | 'live'
- `start_time` string, date-time
- `end_time` string, date-time
- `limit` integer
- `offset` integer
- `variant_id` string
- `variant_name` string
- `in_progress` boolean

## Response `200`

OK.

- object
  - `conversations` Conversation[] — Array of conversations returned in ascending chronological order.
    - `id` string, required — Unique ID for this conversation.
    - `account_id` string, required — ID of the customer account this conversation is under.
    - `project_id` string, required — ID of the project this conversation is under.
    - `variant_id` string — ID of the variant this conversation is in.
    - `variant_name` string — Name of the variant this conversation is in.
    - `environment` string, required — Deployment environment. Usually `live`, `sandbox`, or `pre-release`.
    - `started_at` string, date-time, required — Time when the conversation began, in ISO8601 format.
    - `channel` string, required — Medium of the conversation, e.g. `CHAT` or `VOICE-SIP`.
    - `from_number` string — Caller’s phone number.
    - `to_number` string — Phone number of the agent the caller was connected to.
    - `in_progress` boolean, required — If true, the call is still in progress and its properties may change.
    - `num_turns` integer — Number of turns in the conversation.
    - `total_duration` integer — Duration of the entire call, in seconds.
    - `polyai_duration` integer — Duration of the portion handled by the PolyAI agent, in seconds.
    - `handoff` boolean — Whether the agent handed the call off.
    - `handoff_reason` string — Brief reason why the agent handed the call off.
    - `handoff_destination` string — If multiple destinations exist, which one was used.
    - `num_silences` integer — Number of silence turns.
    - `num_ood` integer — Number of Out-of-Domain turns.
    - `metrics` object — Mapping of metric name -> value(s).
    - `state` object — Mapping of keys -> values written to the dialogue state.
    - `turns` ConversationTurn[] — Ordered list of turns in the conversation.
      - `user_input` string — The transcription of what the user spoke or typed. May be an empty string when no input is present.
      - `user_input_dtmf` string — DTMF digits captured for this turn (e.g. keypad input). May be an empty string when no DTMF was entered.
      - `user_input_datetime` string, date-time — The time when the agent received the user's input. For speech, this is when ASR finished transcribing.
      - `agent_response` string — The transcription of the agent's response to the user. May be an empty string when no response was produced.
      - `agent_response_datetime` string, date-time — The time when the agent responded. For speech, this is when the agent started speaking.
      - `latency` number — Agent latency for this turn (for example, time in seconds between receiving user input and starting the agent response).
      - `translated_user_input` string — User input translated into the agent's working language (typically English) if translation is enabled. May be an empty string when not applicable.
      - `english_agent_response` string — Agent response in English when translation is enabled. May be an empty string when not applicable.
      - `intents` string[] — The list of intents that were found in this turn's input.
      - `entities` object[] — The list of entities that were found in this turn's input.
      - `is_ood` boolean — Whether the turn is classified as Out of Domain (OOD).
      - `is_silence` boolean — Whether the turn is classified as a silence.
  - `descriptions` object — Dictionary of response keys and their descriptions.
    - `conversations` object — Dictionary of Conversation object keys and their descriptions.
  - `next_offset` integer — If present, the result is paginated. Pass this value as `offset` in the next request to fetch the next page.

## Other responses

- `400` — Validation error.
- `401` — Missing or invalid API key.
- `403` — Missing or invalid API key.
- `404` — Resource not found.
- `500` — Internal Server Error.

---

[API](https://skmtc.net/poly/apis/polyai-agents-api.md) · [All operations](https://skmtc.net/poly/apis/polyai-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poly/polyai-agents-api/versions/76f3c606e395/schema)