Skip to main content
GET
/
api
/
user
/
phone-numbers
/
search
Search Available Phone Numbers
curl --request GET \
  --url https://app.famulor.de/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:"DE"
The ISO 3166-1 alpha-2 country code to search in (e.g. DE, GB, AU, CA)
​
contains
string
Filters phone numbers containing specific digits (numeric characters only, maximum 10 digits)

​
Response Fields

​
data
array
Array of available phone numbers

​
Supported Countries

CountryCode
GermanyDE
United StatesUS
CanadaCA
United KingdomGB
AustraliaAU
IsraelIL
PolandPL
FinlandFI
NetherlandsNL
DenmarkDK
ItalyIT
{
  "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
    }
  ]
}
Related pages: Introduction and Authentication Guide, and API Integration Examples.