Skip to main content
GET
Get a batch 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<uuid>
requerido

The Ryvo uuid of the batch call.

Respuesta

The batch with its recipients.

id
string<uuid> | null
requerido

null only if the provider accepted the batch but Ryvo could not record it; use provider_batch_id to find it later.

Ejemplo:

"2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f"

provider_batch_id
string
requerido
Ejemplo:

"btcal_01abcdef"

name
string
requerido
Ejemplo:

"September follow-ups"

status
enum<string>
requerido
Opciones disponibles:
pending,
in_progress,
completed,
cancelled,
failed
Ejemplo:

"in_progress"

agent
object | null
requerido
provider_agent_id
string
requerido
Ejemplo:

"agent_8801kpabc123"

phone_number_id
string<uuid> | null
requerido
provider_phone_number_id
string | null
requerido
Ejemplo:

"phnum_01abcdef"

scheduled_at
string<date-time> | null
requerido
totals
object
requerido
created_at
string<date-time>
requerido
last_synced_at
string<date-time> | null
requerido
retry_count
integer
requerido
concurrency
integer | null
requerido
recipients
object[]
requerido