List toll-free numbers and their verification status
List every toll-free DID the organization owns together with its Toll-Free Verification (TFV) state — status, submission and approval timestamps, any rejection reason, the submitted use case, the carrier / provider submission id, and the business-identity fields (EIN or business registration number + country). Use it to render the TFV dashboard and spot numbers that are unverified or rejected before toll-free traffic is throttled with 30032 errors. Results are keyset-paginated: pass cursor (from the previous page’s meta.pagination) and limit. Scoped to the caller’s owned DIDs so a sibling sub-org sharing the tenant schema never sees another org’s attestation. Read-only; requires the numbers:read scope.
Authorizations
Dashboard JWT token from Clerk
Headers
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.
true, false Query Parameters
Opaque pagination cursor returned as meta.pagination.cursor on the previous page.
Max entries per page (default 25). Values above 200 are silently clamped, never rejected.