Phone Numbers

Search purchasable numbers

Searches live carrier inventory for numbers you can purchase right now. Local searches require areaCode; toll-free searches accept an optional prefix (800–888) or a vanity word. The pricing block reflects what your account would pay today — Pro Bundle discounts and included-number slots are applied automatically.

get/api/v1/numbers/available

Request

Base URL: https://api.callnode.io
URL: https://api.callnode.io/api/v1/numbers/available
Auth: API key in header X-Api-Key and API key in header X-Timestamp and API key in header X-Signature

Query parameters

type'local' | 'tollfree'

areaCodestring

Example:828

3-digit area code. Required when type is local.

prefix'800' | '822' | '833' | '844' | '855' | '866' | '877' | '888'

Toll-free prefix filter. 800 and 822 are usually exhausted.

vanitystring

Toll-free vanity word, 4–7 letters or digits (e.g. NEWCAR). Takes precedence over prefix.

quantityinteger

How many candidates to return.

Response

Matching inventory plus your current pricing. An empty numbers array means no inventory in that area — try another area code or prefix.

countinteger

Example response

{
  "numbers": [
    {
      "phoneNumber": "+16135551234",
      "city": "HICKORY",
      "region": "NC",
      "rateCenter": "HICKORY"
    }
  ],
  "pricing": {
    "monthlyFee": 1.99,
    "perMinuteRate": 0.02
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.