List call logs for the authenticated tenant

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

GET /api/v1/call-logs

cURL

curl --request GET \
  --url 'https://api.voice.stateset.com/api/v1/call-logs' \
  --header "Authorization: Bearer $STATESET_VOICE_API_KEY"

200

{
  "calls": [
    {
      "direction": "inbound",
      "duration_seconds": 142,
      "ended_at": "2024-01-15T10:32:22Z",
      "escalated": false,
      "from_number": "[phone]",
      "function_call_count": 3,
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "outcome": "string",
      "started_at": "2024-01-15T10:30:00Z",
      "status": "completed",
      "stream_sid": "MZ1234567890abcdef1234567890abcdef",
      "to_number": "[phone]",
      "transcript_length": 12
    }
  ],
  "count": 25,
  "next_cursor": "string",
  "ok": true,
  "tenant": "tenant_123"
}

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

Query parameters

status · string

Filter by call status

outcome · string

Filter by normalized terminal outcome: answered, voicemail, no_answer, busy, failed

from_number · string

Filter by caller phone number

to_number · string

Filter by called phone number

direction · string

Filter by call direction (inbound/outbound)

escalated · boolean

Filter by escalation status

from_date · string

Only calls after this ISO8601 datetime

to_date · string

Only calls before this ISO8601 datetime

min_duration · integer (int32)

Minimum call duration in seconds

max_duration · integer (int32)

Maximum call duration in seconds

transcript_search · string

Search transcript text (case-insensitive)

call_sid · string

Filter by Twilio call SID

limit · integer (int64)

Maximum number of results (default 50, max 100)

offset · integer (int64)

Legacy offset-based pagination. Prefer cursor (keyset pagination) for any list longer than a few hundred rows.

cursor · 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

calls · CallLogSummary[] · required

Compact call summaries

Show CallLogSummary

direction · string · required

Call direction: ‘inbound’ or ‘outbound’

duration_seconds · integer,null (int32)

Call duration in seconds

ended_at · string,null

When the call ended (ISO 8601)

escalated · boolean · required

Whether the call was escalated to a human

from_number · string,null

Caller phone number

function_call_count · integer · required

Number of AI function calls made during the conversation

id · string · required

Unique call log identifier

outcome · string,null

Normalized terminal outcome: answered, voicemail, no_answer, busy, failed

started_at · string · required

When the call started (ISO 8601)

status · string · required

Call status: in_progress, completed, failed, escalated, busy, no_answer, canceled

stream_sid · string · required

Twilio stream SID

to_number · string,null

Called phone number

transcript_length · integer · required

Number of transcript turns

count · integer · required

Number of calls returned in this page

next_cursor · 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.

ok · boolean · required

Whether the request succeeded

tenant · string · required

Authenticated tenant identifier

Status codes

Code	Meaning
200	List of call logs
400	Invalid query filter
401	Unauthorized
500	Internal server error
503	Call logging is not configured

cURL

curl --request GET \
  --url 'https://api.voice.stateset.com/api/v1/call-logs' \
  --header "Authorization: Bearer $STATESET_VOICE_API_KEY"

200

{
  "calls": [
    {
      "direction": "inbound",
      "duration_seconds": 142,
      "ended_at": "2024-01-15T10:32:22Z",
      "escalated": false,
      "from_number": "[phone]",
      "function_call_count": 3,
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "outcome": "string",
      "started_at": "2024-01-15T10:30:00Z",
      "status": "completed",
      "stream_sid": "MZ1234567890abcdef1234567890abcdef",
      "to_number": "[phone]",
      "transcript_length": 12
    }
  ],
  "count": 25,
  "next_cursor": "string",
  "ok": true,
  "tenant": "tenant_123"
}