Skip to main content
GET
List calls

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 consulta

limit
integer
predeterminado:20

Page size, 1 to 100. Default 20.

Rango requerido: 1 <= x <= 100
cursor
string

The next_cursor of the previous page. Opaque.

Ejemplo:

"eyJvIjoyMH0"

from
string

Only items at or after this instant. An ISO 8601 date (2026-09-01) or datetime.

Ejemplo:

"2026-09-01T00:00:00Z"

to
string

Only items at or before this instant. An ISO 8601 date or datetime.

Ejemplo:

"2026-09-30T23:59:59Z"

agent_id
string<uuid>

The Ryvo uuid of an agent on either runtime. An unknown id yields an empty list.

status
enum<string>
Opciones disponibles:
completed,
failed,
unknown
channel
enum<string>
Opciones disponibles:
phone,
widget_voice,
unknown
phone
string

An E.164 number.

Pattern: ^\+[1-9]\d{6,14}$
Ejemplo:

"+5215555550100"

Respuesta

A page of calls.

The envelope of every list. data is typed per endpoint.

data
object[]
requerido
has_more
boolean
requerido

Whether another page exists.

Ejemplo:

true

next_cursor
string | null
requerido

Pass as ?cursor= to fetch the next page. null on the last page.

Ejemplo:

"eyJvIjoyMH0"