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
    }
  ]
}