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 compare the credit cost of renting numbers by telephony provider and country. Pricing is reference data and does not reserve inventory or charge the workspace.
When to list phone number pricing
- Estimate rental cost before searching provider inventory.
- Compare country availability across supported telephony providers.
- Display current credit 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 credit amount. Re-read pricing immediately before a purchase because reference pricing can change.
Errors and recovery
401 Unauthorizedmeans the API key is missing or invalid.- An empty array means no current pricing records are available. Do not fall back to a previously cached price for an automated purchase.
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.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Response
Phone number pricing returned successfully.
Example:
"tp_abc123xyz789"
Required string length:
2 - 3Example:
"IN"
Example:
"India"
Example:
"500.0000"
Associated telephony provider metadata.
List Phone Number Pricing