---
title: "Get a conversation by ID"
method: GET
path: "/v1/agents/{agentId}/conversations/{conversationId}"
tags: ["Conversations"]
---

# Get a conversation by ID

`GET /v1/agents/{agentId}/conversations/{conversationId}`

Retrieves a single conversation, including turn-by-turn transcript, metrics, and function events.

**Host:** this endpoint is served from `api.{region}.poly.ai` — *not* the `api.{region}-1.platform.polyai.app` host used by the list-conversations and audio endpoints.

## Path parameters

- `agentId` string, required
- `conversationId` string, required

## Response `200`

Successful response

- ConversationDetailResponse — Public-facing conversation detail (includes turns, metrics, and function events).
  - `conversationId` string, required — Unique ID for this conversation.
  - `accountId` string, required — ID of the customer account this conversation is under.
  - `projectId` string, required — ID of the project this conversation is under.
  - `createdAt` string, date-time
  - `startedAt` string, date-time
  - `finishedAt` string, date-time
  - `channel` string — Conversation medium (e.g. `WEBCHAT`, `VOICE-SIP`).
  - `fromNumber` string — Caller phone number.
  - `toNumber` string — Agent phone number.
  - `language` string — Conversation language code.
  - `variantId` string — Variant ID the conversation ran in.
  - `clientEnv` string — Client environment (`sandbox`, `pre-release`, or `live`).
  - `totalDuration` integer — Total call duration in seconds.
  - `polyaiDuration` integer — PolyAI-handled duration in seconds.
  - `duration` integer — Duration in seconds.
  - `inProgress` boolean — Whether the conversation is still in progress.
  - `handoff` boolean — Whether handoff occurred.
  - `handoffDestination` string — If multiple handoff destinations exist, which one was used.
  - `handoffReason` string — Brief handoff reason.
  - `direction` string — Call direction (e.g. `inbound`, `outbound`).
  - `tags` string[] — Tags applied to the conversation.
  - `polyScore` number — PolyScore quality measure.
  - `shortSummary` string — Short summary of the conversation.
  - `deploymentId` string — Deployment ID.
  - `note` string — Free-text note saved on the conversation.
  - `audioUrl` string — URL to the audio recording.
  - `turns` ConversationTurn[] — Ordered list of conversation turns.
    - `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.
  - `metrics` object — Custom metrics recorded for the conversation.
  - `functionEvents` object — Function execution events that occurred during the conversation.

## 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/revisions/76f3c606e395/schema)