Call Logs API

The Call Logs API provides complete visibility into inbound and outbound voice calls handled by Sayvy AI voice agents and telephony providers. Each call record contains lifecycle timestamps, duration metrics, speech-to-text transcripts, AI-generated summaries, cost calculations, and secure access to audio recordings.

+-------------------------------------------------------------+
|                Voice Call Telephony Pipeline                |
|                                                             |
|   +-----------------------+     +-----------------------+   |
|   |  Inbound Caller Dial  |     | Outbound Agent Trigger|   |
|   +-----------+-----------+     +-----------+-----------+   |
|               \                             /               |
|                v                           v                |
|              +-------------------------------+              |
|              |     WebRTC / SIP Gateway      |              |
|              | (Twilio / Plivo / WhatsApp)   |              |
|              +---------------+---------------+              |
|                              |                              |
|                              v                              |
|              +-------------------------------+              |
|              |   Sayvy AI Voice Orchestrator |              |
|              |   (LLM + STT + TTS Pipeline)  |              |
|              +---------------+---------------+              |
|                              |                              |
|              +---------------+---------------+              |
|              |                               |              |
|              v                               v              |
|     +-----------------+             +-----------------+     |
|     |  Object Storage |             | PostgreSQL DB   |     |
|     | (Audio Streams) |             | (Call Metadata) |     |
|     +-----------------+             +-----------------+     |
+-------------------------------------------------------------+

Key Capabilities

Detailed Call Auditing

Track caller and recipient phone numbers, agent identifiers, directional flows (inbound or outbound), and precise connection timestamps.

Speech-to-Text & Summaries

Access full dialog transcripts and structured, AI-generated summaries capturing caller intent, outcomes, and sentiment.

Secure Recording Streaming

Stream and download encrypted .ogg call recordings via a secure proxy endpoint without exposing cloud bucket credentials.

Usage & Cost Tracking

Inspect calculated billable duration and per-call carrier/compute costs for complete financial transparency.

Call Lifecycle Statuses

Calls transition through standardized states during their execution:

Status	Description
`initiated`	Call has been dispatched to telephony provider or incoming hook received
`ringing`	Destination device is alerting; ringing signal acknowledged
`in-progress`	Audio channel established; speech agent or user actively conversing
`completed`	Call terminated normally; duration and billing computed
`busy`	Recipient line was engaged or rejected
`failed`	Carrier failure, invalid number, or signaling timeout
`no-answer`	Ringing timeout reached without recipient picking up

Available Endpoints

Method	Endpoint	Description
GET	`/api/v1/call-logs`	List call history logs with pagination, status, direction, and query filters
GET	`/api/v1/call-logs/{call_log_id}`	Retrieve details, transcript, and summary for a specific call
GET	`/api/v1/call-logs/{call_log_id}/audio`	Securely stream or download the recorded call audio stream (`audio/ogg`)

Overview

Agents

Campaigns

Contacts

Templates

Knowledge Base

Webhooks

Call Logs

Quick Replies

Inbox

Call Logs Overview

Call Logs API

Key Capabilities

Detailed Call Auditing

Speech-to-Text & Summaries

Secure Recording Streaming

Usage & Cost Tracking

Call Lifecycle Statuses

Available Endpoints

​Call Logs API

​Key Capabilities

Detailed Call Auditing

Speech-to-Text & Summaries

Secure Recording Streaming

Usage & Cost Tracking

​Call Lifecycle Statuses

​Available Endpoints

Call Logs API

Key Capabilities

Call Lifecycle Statuses

Available Endpoints