Skip to main content
GET
Returns a paginated list of call logs with summary information. Use query parameters to filter by status, phone number, direction, etc.

Query parameters

string
Filter by call status
string
Filter by normalized terminal outcome: answered, voicemail, no_answer, busy, failed
string
Filter by caller phone number
string
Filter by called phone number
string
Filter by call direction (inbound/outbound)
boolean
Filter by escalation status
string
Only calls after this ISO8601 datetime
string
Only calls before this ISO8601 datetime
integer (int32)
Minimum call duration in seconds
integer (int32)
Maximum call duration in seconds
Search transcript text (case-insensitive)
string
Filter by Twilio call SID
integer (int64)
Maximum number of results (default 50, max 100)
integer (int64)
Legacy offset-based pagination. Prefer cursor (keyset pagination) for any list longer than a few hundred rows.
string
Opaque keyset cursor returned by a previous response’s next_cursor. Pass it back to fetch the next page; takes precedence over offset.

Response

CallLogsListResponse
CallLogSummary[]
required
Compact call summaries
integer
required
Number of calls returned in this page
string,null
Opaque cursor to pass back as ?cursor=... to fetch the next page. null when this is the last page. Prefer this over offset for large tenants — it is O(log n) regardless of page depth.
boolean
required
Whether the request succeeded
string
required
Authenticated tenant identifier

Status codes