Skip to main content
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

Match telephony_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.
This read-only operation does not prove that a number is currently available. Search inventory before purchasing, and record the cost from your billing plan rather than from this catalog.

Errors and recovery

  • 401 Unauthorized means the API key is missing or invalid.
  • An empty array means no pricing records are available. Purchases are still priced by your billing plan.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Phone number pricing returned successfully.

success
enum<boolean>
required
Available options:
true
error
enum<boolean>
required
Available options:
false
statusCode
integer
required
Example:

200

message
string
required
Example:

"Success"

data
object[]
required
timestamp
string<date-time>
required