Skip to main content
GET
Get a call

Autorizaciones

Authorization
string
header
requerido

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_...

Parámetros de ruta

id
string
requerido

The Ryvo uuid of the conversation, or the call_... handle returned by POST /v1/calls.

Ejemplo:

"call_conv_01abcdef"

Respuesta

The call, or the placeholder for a call still in flight.

id
string<uuid>
requerido
Ejemplo:

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

call_id
string | null
requerido

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

Ejemplo:

"call_conv_01abcdef"

runtime
enum<string>
requerido

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

Opciones disponibles:
engine,
elevenlabs
Ejemplo:

"engine"

channel
enum<string>
requerido
Opciones disponibles:
phone,
widget_voice,
chat,
widget_chat,
whatsapp,
unknown
Ejemplo:

"phone"

agent
object | null
requerido
status
enum<string>
requerido

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

Opciones disponibles:
completed,
failed,
in_progress,
unknown
Ejemplo:

"completed"

from
string | null
requerido
Ejemplo:

"+5215555550199"

to
string | null
requerido
Ejemplo:

"+5215555550100"

customer_phone
string | null
requerido

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

Ejemplo:

"+5215555550100"

started_at
string<date-time> | null
requerido
Ejemplo:

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

ended_at
string<date-time> | null
requerido
Ejemplo:

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

duration_seconds
integer | null
requerido
Ejemplo:

208

credits
number | null
requerido

What the conversation cost, in credits.

Ejemplo:

640

summary
string | null
requerido
Ejemplo:

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

has_audio
boolean
requerido

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

termination_reason
string | null
requerido
Ejemplo:

"user_hangup"

evaluation
object[]
requerido
data_collection
object | null
requerido
Ejemplo:
transcript_available
boolean
requerido