Endpoint reference
List operational call history.
Use this endpoint to reconcile outbound workflows, support audit trails, call outcomes, escalation state, and analytics exports.
Endpoint contract
| Property | Value |
|---|---|
| Method | GET |
| Path | /api/v1/call-logs |
| Authentication | Authorization: Bearer ${STATESET_VOICE_API_KEY} |
| Primary use | List operational call records for reconciliation, support audit, and analytics. |
Query parameters
| Parameter | Description |
|---|---|
limit | Maximum number of records to return. Use small pages for interactive dashboards. |
offset | Offset for pagination. Keep export windows stable when exporting large ranges. |
status | Filter by call status such as queued, completed, failed, or no-answer. |
direction | Filter inbound and outbound records. |
from/to | Use time-window filters for replay, audit, and reporting jobs where supported. |
Example request
curl -sS "https://voice.stateset.app/api/v1/call-logs?limit=25&offset=0" \
-H "Authorization: Bearer ${STATESET_VOICE_API_KEY}"Response shape
{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"call_sid": "CA1234567890abcdef1234567890abcdef",
"direction": "outbound",
"status": "completed",
"duration_seconds": 142,
"escalated": false,
"summary": "Customer confirmed appointment time."
}
],
"limit": 25,
"offset": 0
}Export pattern
- Choose a stable time window and page through records with
limitandoffset. - Store the highest processed timestamp or call log ID after each successful page.
- Reconcile final call state against webhook events when downstream systems need exactly-once business effects.
- Alert on missing final states, duplicate call SIDs, and unusually high failure or no-answer rates.
Common use cases
Support
Audit a customer call
Find the final call status, route, summary, and escalation state before reviewing the session transcript.
Operations
Track launch quality
Measure answer rate, completion rate, transfer rate, no-answer spikes, and provider failures by tenant and route.