Skip to main content
GET
Get a conversation by ID

Authorizations

X-API-KEY
string
header
required

Path Parameters

agentId
string
required
conversationId
string
required

Response

Successful response

Public-facing conversation detail (includes turns, metrics).

conversationId
string
required
accountId
string
required
projectId
string
required
createdAt
string | null
startedAt
string | null
finishedAt
string | null
channel
string | null
fromNumber
string | null
toNumber
string | null
language
string | null
variantId
string | null
clientEnv
string | null
totalDuration
integer | null
polyaiDuration
integer | null
duration
integer | null
inProgress
boolean | null
handoff
boolean | null
handoffDestination
string | null
handoffReason
string | null
direction
string | null
tags
string[] | null
polyScore
number | null
polyScoreV2
number | null

PolyScore on the 1-5 scale

customScores
object[] | null

Results for the project's AI Scores, sorted by name. An AI Score that was never run on this conversation (created after it ended, inactive at the time, or limited to other channels) has no entry. One that ran but was skipped or failed has an entry with that state and a null score

shortSummary
object | null

Structured short summary with a heading and content.

deploymentId
string | null
note
string | null
audioUrl
string | null
turns
object[] | null
metrics
object | null
functionEvents
object | null
Last modified on October 1, 2026