Skip to main content
GET
/
organization-phone-numbers
/
provider-numbers
Search available phone numbers
curl --request GET \
  --url https://api.dialnexa.com/v1/organization-phone-numbers/provider-numbers \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "phone_number": "+912234567890",
      "country": "IN",
      "type": "local",
      "monthly_cost_usd": 1.5,
      "capabilities": [
        "voice"
      ]
    }
  ]
}
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

ParameterDescription
country_codeISO 3166-1 alpha-2 country code, e.g. IN for India, US for United States.
area_codeFilter by area code or number prefix.
number_typelocal, toll-free, or mobile.
limitMax results to return (default 20).

​
Tip

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

​
Request

curl "https://api.dialnexa.com/v1/organization-phone-numbers/provider-numbers" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "data": [
    {
      "phone_number": "+912234567891",
      "country_code": "IN",
      "type": "local",
      "monthly_cost_usd": "1.15",
      "capabilities": ["voice"]
    },
    {
      "phone_number": "+912234567892",
      "country_code": "IN",
      "type": "local",
      "monthly_cost_usd": "1.15",
      "capabilities": ["voice"]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Pass your API key as a Bearer token in the Authorization header.

Query Parameters

​
country_code
string

ISO 3166-1 alpha-2 country code, e.g. IN, US.

​
area_code
string
​
number_type
enum<string>
Available options:
local,
toll-free,
mobile
​
limit
integer
default:20

Response

200 - application/json

Success.

​
data
object[]