Skip to main content

​
Treat call logs as your system of record for execution outcomes.

Callaro stores completed and in-flight call records in voice_sessions. Use call-log-exports for asynchronous bulk extraction, and trace endpoints for deep debugging.

​
Core endpoints

curl "https://api.callaro.ai/api/v1/voice_sessions?cursor=eyJpZCI6OTAwMX0&page_size=50" -H "X-Api-Key: $CALLARO_API_KEY"
curl "https://api.callaro.ai/api/v1/voice_sessions/9001" -H "X-Api-Key: $CALLARO_API_KEY"
curl -L "https://api.callaro.ai/api/v1/voice_sessions/9001/recording" -H "X-Api-Key: $CALLARO_API_KEY"
curl "https://api.callaro.ai/api/v1/voice_sessions/9001/events" -H "X-Api-Key: $CALLARO_API_KEY"
curl "https://api.callaro.ai/api/v1/voice_sessions/9001/trace" -H "X-Api-Key: $CALLARO_API_KEY"
curl "https://api.callaro.ai/api/v1/voice_sessions/9001/transcript_pdf" -H "X-Api-Key: $CALLARO_API_KEY"

​
Export jobs

curl -X POST "https://api.callaro.ai/api/v1/call-log-exports" -H "X-Api-Key: $CALLARO_API_KEY" -H "Content-Type: application/json" -d '{"date_from":"2026-04-01","date_to":"2026-04-23","filters":{"campaign_id":"cmp_123"}}'
curl "https://api.callaro.ai/api/v1/call-log-exports/77" -H "X-Api-Key: $CALLARO_API_KEY"
curl "https://api.callaro.ai/api/v1/call-log-exports/77/download" -H "X-Api-Key: $CALLARO_API_KEY"

​
Operational guidance

1

Use cursor traversal for voice sessions

Read until data.next_cursor is absent. Avoid page counters for cursor endpoints.
2

Follow redirects for recordings

Recording endpoints can return redirects to object storage; clients must support redirect follow.
3

Use export jobs for large windows

For month-scale extraction, create export jobs instead of paging every session synchronously.
4

Join with webhook outcomes by call identifiers

Reconcile using voice_session_id, call_id, and provider call_sid.
Do not assume recording URLs are permanent. Persist your own archival copy if retention policies require long-lived access.