Quote a phone number
Returns what one more number of this country and number_type costs each month, before you buy it: monthly (integer minor units with currency, null when free), free, reason (first_number_free, monthly_fee or unknown_price), requires_payment_method and twilio_cost (the carrier’s monthly price in US cents). On Brokerage and Enterprise the first number is free; every other number costs the carrier’s monthly price plus 30%, billed monthly. Numbers on your own carrier cost nothing here. A key with number:read instead of billing:read also works.
Scopes: billing:read
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"
Query Parameters
^[A-Za-z]{2}$local, mobile, national, toll_free