Skip to main content
GET
Get available phone numbers from the specified provider
Legacy endpoint - deprecated. Unversioned endpoints are scheduled for removal on July 31, 2026. Use the /v1 version for new integrations. This endpoint remains available for existing integrations until then.
Searches your telephony provider for available phone numbers that you can purchase. Filter by country, area code, or number type to find what you need. The response includes the monthly rental cost and capabilities (voice, SMS) for each number.

Query parameters

Tip

Once you find a number you want, pass it to Purchase a Number to add it to your account.

Authorizations

Authorization
string
header
required

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

Headers

x-organization-id
string
required

RSA-encrypted organization_id string (base64 format)

Query Parameters

country_iso
string
required

ISO country code (e.g., US, GB, CA)

Example:

"US"

telephony_provider_id
string
required

ID of telephony provider (14-char string)

Example:

"prov_plivo_123456"

region
string

Region/state to filter numbers by

Example:

"Karnataka"

Response

Available phone numbers retrieved successfully

telephonyProviderId
string
required

ID of telephony provider (14-char string)

providerName
string
required

Provider name (Plivo or Twilio)

data
object
required

Phone numbers data from the provider