Skip to main content
GET
List toll-free numbers and their verification status

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

cursor
string

Opaque pagination cursor returned as meta.pagination.cursor on the previous page.

limit
string

Max entries per page (default 25). Values above 200 are silently clamped, never rejected.

Response

A page of toll-free numbers with their TFV status.

A page of toll-free numbers with their TFV status.

data
object[]
meta
object