Sign in
OpenAPI 3.1.02026-08-215701892.2 MB

15e893e69e8c

Phone Numbers

Get KYC form spec

For a Tier 3/4 country, the fields the end customer must provide (Telnyx regulatory requirements) before a number can be ordered: text, date, address, or file (document) per requirement.

get/v1/phone-numbers/kyc

Query parameters

countrystring required
numberType'local' | 'mobile' | 'national' | 'toll_free'

Requirements and reuse eligibility are per (country, type). Omitted = the country's default type. Pass the same value on the POST.

Response

The KYC form spec.

countrystring
numberTypestring
pendingReviewboolean

true when this account already has a number for this country in regulatory review (status pending_regulatory). Scope is the whole account across all profiles, and the country only (any number type), so it is not a per-end-client signal on a multi-tenant setup. Informational only: it never blocks a submission, and several same-country numbers may sit in review at once. For a per-end-client view, call GET /v1/phone-numbers with profileId and status=pending_regulatory; that view also lists numbers declined in the last 30 days.