Export the number inventory as CSV or JSON
Download the organization’s full owned-DID inventory as a single CSV (default) or JSON file for finance reconciliation and bulk auditing — the same rows the dashboard Numbers list shows, plus a trailing-30-day realised spend column per number. Use it to reconcile the monthly DID line without paging the list API. Filter with status, country_code, and search; CSV timestamps localise to the tz/locale you pass. Capped at 50,000 rows, with the X-Truncated header set when a larger inventory is truncated. Read-only; requires the numbers:read scope. Inbound DID provisioning only (invariant #45 untouched).
Authorizations
Dashboard JWT token from Clerk
Query Parameters
Output format — a CSV attachment (default) or a JSON array.
csv, json Status filter (e.g. active); defaults to all so released/parked-but-still-billable rows are included.
ISO 3166-1 alpha-2 country filter.
Free-text match on the phone number or label.
IANA timezone for CSV timestamp columns (e.g. Europe/Istanbul); JSON stays canonical UTC.
BCP-47 locale for CSV date formatting (defaults to en-US).
Response
The inventory export as a downloadable attachment. X-Row-Count carries the row count and X-Truncated is set when the 50,000-row cap was hit.
The response is of type string.