Get phone-number rental prices for a country
Twilio Pricing API parity for phone numbers: returns the monthly rental cost of purchasable DIDs in one country (ISO 3166-1 alpha-2 country query param), grouped by number type (local, mobile, toll-free, national, short code) with the cheapest available price and how many are in stock. Only unassigned, purchasable inventory is counted. Use it to preview number costs before buying. Returns an empty list when the country has no purchasable inventory.
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 Response
Phone-number prices in the standard { data, meta } envelope with the resolved country and a phoneNumbers array of { numberType, monthlyCost, currency, available, total } rows.
Phone-number prices in the standard { data, meta } envelope with the resolved country and a phoneNumbers array of { numberType, monthlyCost, currency, available, total } rows.