Telephony
Call History
GET /api/v1/call-logs — list past inbound and outbound calls.
Lists call history for your organization (or your project, for a project-scoped key), across every phone configuration.
GET /api/v1/call-logsQuery parameters
| Parameter | Type | Description |
|---|---|---|
trunkId | string (UUID) | Restrict to one phone configuration. Must belong to your organization/project. |
direction | inbound | outbound | Restrict to one direction. |
status | string | Comma-separated: ringing, answered, completed, no_answer, busy, failed. |
from | string (ISO 8601 datetime) | Only calls started at or after this time. |
to | string (ISO 8601 datetime) | Only calls started at or before this time. |
after | string (UUID) | Cursor from a previous response's nextCursor — fetches the next page. |
limit | number | Max rows to return. Default 25, max 100. |
Response
200 OK:
{
"data": [
{
"id": "c1a2b3d4-...",
"trunkId": "3f9c1a2e-...",
"phoneNumberId": "8b1e4a2f-...",
"direction": "outbound",
"callerNumber": "+15557654321",
"calleeNumber": "+15551234567",
"status": "completed",
"startedAt": "2026-08-27T10:00:00.000Z",
"answeredAt": "2026-08-27T10:00:05.000Z",
"endedAt": "2026-08-27T10:01:00.000Z",
"durationSeconds": 55,
"providerCallId": "d290f1ee-...",
"createdAt": "2026-08-27T10:00:00.000Z",
"updatedAt": "2026-08-27T10:01:00.000Z"
}
],
"nextCursor": null,
"total": 1
}Paginate by passing the last row's id as after on the next request; nextCursor is null once you've reached the last page.
What can't appear here
Call history is built from LiveKit's own call events — it can only ever show a call that actually
reached a room (answered/completed). A call rejected upstream by the carrier (no capacity, bad
routing, network failure) never creates a room, so it never appears in this endpoint. Check the
carrier's own dashboard/CDR for calls that failed before ringing.
Errors
| Status | error | When |
|---|---|---|
400 | validation error | A query parameter fails validation |
403 | forbidden | trunkId doesn't belong to your organization/project |
Example
curl "https://api.elizon.com/api/v1/call-logs?direction=outbound&limit=10" \
-H "X-API-Key: elz_your_key_here"