Skip to main content
GET
List call logs

Authorizations

Authorization
string
header
required

Your API key from the Wave dashboard. Sandbox keys start sk_sandbox_; production keys start sk_live_. Send as Authorization: Bearer <key>. Some endpoints require a production key and specific scopes.

Query Parameters

cursor
string

Cursor mode: the next_cursor of the previous page. Cannot be sent with page or page_size.

limit
integer
default:20

Cursor mode: page size.

Required range: 1 <= x <= 100
page
integer

Page mode: the page number, starting at 1. Cannot be sent with cursor.

Required range: x >= 1
page_size
integer

Page mode: calls per page (default 20). Cannot be sent with cursor.

Required range: 1 <= x <= 100
status
enum<string>

Only calls with this status (one raw value).

Available options:
initiated,
ringing,
answered,
ended,
missed,
failed,
cancelled,
timeout
from
string<date-time>

Only calls created at or after this time (ISO 8601 date-time).

to
string<date-time>

Only calls created at or before this time (ISO 8601 date-time).

queue_id
string

Only calls from this queue. Only callback calls carry a queue id.

api_key_id
string<uuid>

Only calls that this API key placed (a UUID). A revoked key of the project works too.

environment
enum<string>

sandbox or production. An API key reads only its own key environment: leave this out, or send the key's own value. Another value returns 400 VALIDATION_ERROR.

Available options:
sandbox,
production

Response

A page of call logs. Cursor mode returns CallList; page mode returns CallListPage.

Cursor mode.

data
object[]
next_cursor
string | null
limit
integer