Skip to main content
GET
List WhatsApp Business Call logs

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Headers

X-Test-Mode
enum<string>

Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.

Available options:
true,
false

Query Parameters

status
string

CSV of statuses to include. Allowed: queued, ringing, in_progress, completed, failed, missed.

Maximum string length: 128
direction
enum<string>
Available options:
inbound,
outbound
waba_id
string
Maximum string length: 64
phone_number_id
string
Maximum string length: 64
start
string<date-time>
end
string<date-time>
q
string
Maximum string length: 128
cursor
string
Maximum string length: 256
limit
integer
default:50
Required range: 1 <= x <= 200

Response

Call logs

Call logs

data
object[]
meta
object