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

Match telephony_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.
This read-only operation does not prove that a number is currently available. Search inventory before purchasing, and verify the final purchase response before recording a cost.

Errors and recovery

  • 401 Unauthorized means 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.

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.

telephony_provider_id
string
required
Example:

"tp_abc123xyz789"

country_iso
string
required
Required string length: 2 - 3
Example:

"IN"

country_name
string
required
Example:

"India"

credit_cost
required
Example:

"500.0000"

created_at
string<date-time>
updated_at
string<date-time>
telephonyProvider
object

Associated telephony provider metadata.