Phone Numbers
List Phone Number Pricing
List DialNexa phone number rental pricing by telephony provider and country before provisioning a number.
GET
List Phone Number Pricing
Read only
List phone number pricing to read DialNexa’s reference catalog of number rental prices by telephony provider and country. Pricing is reference data and does not reserve inventory or charge the workspace. A purchase is charged the rental rate in your workspace billing plan, not this
credit_cost; see Buy Phone Number.
When to list phone number pricing
- Get an indicative rental cost before searching provider inventory.
- Compare country availability across supported telephony providers.
- Display reference pricing in an internal provisioning workflow.
Verify the result
Matchtelephony_provider_id and country_iso to the provider and country you plan to use. Read credit_cost as a decimal amount, which the API returns as a string such as "500.0000". The amount actually charged comes from your billing plan, so confirm it with your plan before an automated purchase.
Errors and recovery
401 Unauthorizedmeans the API key is missing or invalid.- An empty array means no pricing records are available. Purchases are still priced by your billing plan.
Related endpoints
- Search Available Numbers: find numbers currently available from the provider.
- Buy a Phone Number: provision a selected number.
- List Phone Numbers: verify numbers already owned by the workspace.