Skip to main content
GET
Get a conversation

Authorizations

Authorization
string
header
required

Send Authorization: Bearer YOUR_API_KEY. The key resolves to a single organization.

Path Parameters

id
string<uuid>
required

Response

The conversation.

id
string<uuid>
required
agentId
string<uuid>
required
name
string
required
source
string
required

Where the conversation came from, e.g. vapi, retell, speechify, livekit, upload. zelto means it was sent through the API (POST /webhooks/calls) or the MCP upload_conversation tool.

createdAt
string<date-time>
required
updatedAt
string<date-time>
required
receiverId
string<uuid> | null
referenceId
string | null
endedReason
string | null
cost
string | null

Provider-reported cost in dollars, as a string for precision.

startedAt
string<date-time> | null

When the conversation actually began, as sent in call.startedAt. Null when the sender gave no start time (createdAt is then when Zelto received it).

durationSeconds
integer | null

Length in whole seconds: the sent call.durationSeconds, else derived from call.startedAt and call.endedAt, else the last transcript turn offset. Null when none of those were sent.

analysisStatus
enum<string>

Whether Zelto analyzed this conversation. Present on GET /v1/conversations and GET /v1/conversations/{id}. analyzed: it was admitted to analysis (its minutes were counted against the plan allowance). pending: stored, analysis has not settled yet. skipped_too_short: fewer than 4 turns, stored but never analyzed. skipped_plan_limit: its whole duration did not fit in the monthly minutes left when it arrived (a shorter conversation that still fits is analyzed). skipped_no_duration: a voice conversation sent without a duration. unknown: not derivable. New values may be added later; treat one you do not know as "not analyzed yet".

Available options:
analyzed,
pending,
skipped_too_short,
skipped_plan_limit,
skipped_no_duration,
unknown