Skip to main content
GET
Get a conversation

Authorizations

Authorization
string
header
required

A Bearer token. Create keys in the portal under Settings > API keys (https://app.ryvo.so/developers). The token has the form ryvo_live_<64 hex characters> and is shown once.

Header: Authorization: Bearer ryvo_live_...

Path Parameters

id
string<uuid>
required

The Ryvo uuid of the conversation.

Response

The conversation.

id
string<uuid>
required
Example:

"0f1e2d3c-4b5a-4968-8776-655443322110"

call_id
string | null
required

The call_... handle returned by POST /v1/calls; null on the Engine runtime.

Example:

"call_conv_01abcdef"

runtime
enum<string>
required

engine is the Ryvo runtime; elevenlabs is the legacy voice runtime.

Available options:
engine,
elevenlabs
Example:

"engine"

channel
enum<string>
required
Available options:
phone,
widget_voice,
chat,
widget_chat,
whatsapp,
unknown
Example:

"phone"

agent
object | null
required
status
enum<string>
required

in_progress and unknown come from the runtime; initiated only appears on a call still being placed.

Available options:
completed,
failed,
in_progress,
unknown
Example:

"completed"

from
string | null
required
Example:

"+5215555550199"

to
string | null
required
Example:

"+5215555550100"

customer_phone
string | null
required

The end user's number. This is what ?phone= matches.

Example:

"+5215555550100"

started_at
string<date-time> | null
required
Example:

"2026-09-20T10:11:12.000Z"

ended_at
string<date-time> | null
required
Example:

"2026-09-20T10:14:40.000Z"

duration_seconds
integer | null
required
Example:

208

credits
number | null
required

What the conversation cost, in credits.

Example:

640

summary
string | null
required
Example:

"The customer booked a cleaning for Tuesday at 10 am."

has_audio
boolean
required

Whether GET /v1/calls/{id}/audio has a recording.

termination_reason
string | null
required
Example:

"user_hangup"

messages_count
integer | null
required
Example:

12

evaluation
object[]
required
data_collection
object | null
required
transcript_available
boolean
required