Skip to main content
GET
/
user
/
phone-numbers
/
search
Search available phone numbers
curl --request GET \
  --url https://call.aiployees.com/api/user/phone-numbers/search \
  --header 'Authorization: Bearer <token>'
{
  "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
    }
  ]
}
This endpoint allows you to search for available phone numbers from our provider. Use the results to find a number you want to purchase.

​
Query Parameters

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

​
Response

​
data
array
Array of available phone numbers
{
  "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
    }
  ]
}

​
Supported Countries

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