Skip to main content
POST
/
search-phone-numbers
curl -X POST https://api.magpipe.ai/functions/v1/search-phone-numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "area_code": "604",
    "country": "CA",
    "limit": 5
  }'

{
  "numbers": [
    {
      "phone_number": "+16045551234",
      "friendly_name": "(604) 555-1234",
      "locality": "Vancouver",
      "region": "BC",
      "capabilities": {
        "voice": true,
        "sms": true,
        "mms": true
      },
      "monthly_cost": 2.00
    },
    {
      "phone_number": "+16045555678",
      "friendly_name": "(604) 555-5678",
      "locality": "Vancouver",
      "region": "BC",
      "capabilities": {
        "voice": true,
        "sms": true,
        "mms": true
      },
      "monthly_cost": 2.00
    }
  ]
}
Search for available phone numbers to add to your account. Filter by area code, country, number type, and pattern matching.

​
Request Body

Send one of areaCode, state, city, or query. If none provided with just numberType, returns default US numbers.
​
areaCode
string
3-digit area code to search in.Example: 604
​
state
string
2-letter US state or Canadian province code. Auto-detects Canadian provinces.Example: CA, NY, BC, ON
​
city
string
City name. Supports 40+ major US and Canadian cities.Example: vancouver, san francisco, new york
​
numberType
string
default:"local"
Number type: local or tollFree.
​
query
string
Legacy free-text search. Accepts area codes, city names, state codes, or canada/usa.
Returns up to 75 numbers per search (3 pages of 25 in the UI).

​
Response

​
numbers
array
Array of available phone numbers with details.

​
Number Object

​
phone_number
string
The phone number in E.164 format.
​
friendly_name
string
Human-readable formatted number.
​
locality
string
City or region for local numbers.
​
region
string
State or province code.
​
capabilities
object
What the number supports: voice, sms, mms.
​
monthly_cost
number
Monthly cost in USD.
curl -X POST https://api.magpipe.ai/functions/v1/search-phone-numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "area_code": "604",
    "country": "CA",
    "limit": 5
  }'

{
  "numbers": [
    {
      "phone_number": "+16045551234",
      "friendly_name": "(604) 555-1234",
      "locality": "Vancouver",
      "region": "BC",
      "capabilities": {
        "voice": true,
        "sms": true,
        "mms": true
      },
      "monthly_cost": 2.00
    },
    {
      "phone_number": "+16045555678",
      "friendly_name": "(604) 555-5678",
      "locality": "Vancouver",
      "region": "BC",
      "capabilities": {
        "voice": true,
        "sms": true,
        "mms": true
      },
      "monthly_cost": 2.00
    }
  ]
}