Call logs
The Calls API provides access to call history, recordings, transcripts, and real-time call events.
Base URL: https://api.krosai.com/v1/calls
List Calls
Retrieve call history with filtering and pagination.
Endpoint
GET /calls
Query Parameters
Parameter | Type | Description |
| string | Filter by status: |
| string | Filter by direction: |
| string | Filter by phone number |
| string | Filter by endpoint |
| string | Start date (ISO 8601) |
| string | End date (ISO 8601) |
| integer | Results per page (default: 50, max: 100) |
| integer | Pagination offset |
Get Call
Retrieve detailed information about a specific call.
Get Call Statistics
Get aggregated statistics for calls.
Query Parameters
| string | Filter by phone number |
| string | Filter by endpoint |
| string | Start date (ISO 8601) |
| string | End date (ISO 8601) |
Get Call Events
Retrieve the event timeline for a specific call.
Hangup Call
Terminate an active call.
Call Status Values
| Call is being set up |
| Destination is ringing |
| Call is active |
| Call ended normally |
| Call failed to connect |
| Destination was busy |
| No answer at destination |
Hangup Causes
| Normal call termination |
| Caller hung up |
| Agent/endpoint hung up |
| Destination didn't answer |
| Destination busy |
| Call rejected |
| Network failure |
| Call timed out |
Recordings
Call recordings are automatically generated for completed calls and stored securely.
Recording URL
Recordings are available via the recording_url field:
https://storage.krosai.com/recordings/call_abc123.mp3
Recording Formats
- Format: MP3
- Sample Rate: 48kHz
- Channels: Mono (mixed)
- Retention: 90 days (configurable)
Transcripts
Full transcripts are generated using speech-to-text and available in the transcript field.
Transcript Format
Plain text with speaker labels (when available):
[Agent]: Hello, how can I help you today?
[Caller]: Hi, I'm calling about my order status.
[Agent]: I'd be happy to help. Can you provide your order number?
...
On this page
- Call logs