Skip to main content
Searches for available phone numbers from the telephony provider. Use the results to find a number to purchase.

​
Endpoint

GET /user/phone-numbers/search

​
Query parameters

​
country_code
string
default:"US"
ISO 3166-1 alpha-2 country code to search in (e.g., US, GB, CA).
​
contains
string
Filter numbers that contain specific digits. Numeric characters only, maximum 10 digits.

​
Response

​
data
array
Array of available phone numbers.

​
Supported countries

CountryCode
United StatesUS
CanadaCA
United KingdomGB
AustraliaAU
IsraelIL
PolandPL
FinlandFI
NetherlandsNL
DenmarkDK
ItalyIT

​
Example

curl -X GET "https://portal.intellixent.ai/api/user/phone-numbers/search?country_code=US" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 Response
{
  "data": [
    {
      "phone_number": "+14155551234",
      "phone_number_formatted": "+1 415-555-1234",
      "country_code": "US",
      "price": 3.99,
      "stripe_price_id": "price_1PkA4dBXoZOzqQuAsvGvVJTZ",
      "address_requirements": "none",
      "sms_capable": true
    },
    {
      "phone_number": "+14155555678",
      "phone_number_formatted": "+1 415-555-5678",
      "country_code": "US",
      "price": 3.99,
      "stripe_price_id": "price_1PkA4dBXoZOzqQuAsvGvVJTZ",
      "address_requirements": "none",
      "sms_capable": false
    }
  ]
}
Pass a number from these results to the Purchase phone number endpoint.