Skip to content

Lookup

Know the number before you spend on it.

One free request tells you whether a number is valid, where it is, what kind of line it is, whether it is risky, and what a call or a text to it costs today.

$0

Per lookup

60

Lookups a minute per caller

$0.0260/min

Cheapest call to the sample UK mobile, live

10min

Each answer cached for

Overview

Validate, classify and price in one call

Lookup reads a number against the rate decks of every live route on the marketplace and the number-range data behind each mobile network. Use it to clean a list, block risky destinations and pick a channel before you send or dial.

At a glance

Request
GET /lookup/{number}
Price
Free
Auth
None needed; a restricted key needs routes:read
Method
Prefix-based, no live network query
Rate limit
60 a minute per caller
Freshness
Cached per number for 10 minutes

Capabilities

What one lookup returns

  • Validity and format

    Whether the digits form a valid international number, with the E.164 form and a readable international format, or the reason it is not valid.

    valid, e164, reason

  • Country

    Read from the rate decks that serve the number, or from the dial code. Shared codes such as +1 resolve to one country only when the decks agree.

    country

  • Number type

    Mobile, fixed, toll-free or premium, by a vote across every live route's deck, with a confidence score.

    numberType, numberTypeConfidence

  • Likely mobile network

    The network the number's range was allocated to, with its MCC-MNC. A ported number can have moved, so treat it as likely.

    network

  • Risk flags

    Blocked and embargoed destinations, premium numbers and the high-risk prefixes most often abused for revenue-share fraud, each with a plain reason.

    risk

  • What it costs to reach

    The cheapest public voice and SMS route for that exact number, with the rate, the billing increment and how many routes serve it.

    pricing.voice, pricing.sms

Look a number up

One GET, no key required

Pass the number in the path. Spaces, dashes and brackets are stripped. A number that is not valid still answers, with valid set to false and the reason.

  • Use the risk flags to refuse a send before it costs anything.
  • Use pricing to choose between a text and a call for each number.
# Free. A key is optional; a restricted key needs routes:read.
curl "https://packetexchange.io/api/v1/lookup/447911123456"

Live response for a UK mobile number, data

{
  "valid": true,
  "e164": "+447911123456",
  "country": {
    "iso": "GB",
    "name": "United Kingdom",
    "dialCode": "44"
  },
  "numberType": "unknown",
  "network": {
    "mccMnc": "234-50",
    "operator": "JT",
    "source": "range"
  },
  "risk": {
    "blocked": false,
    "sanctioned": false,
    "highRisk": false
  },
  "pricing": {
    "voice": {
      "rate": "0.026000",
      "unit": "min",
      "billingIncrement": "1/1",
      "routesServing": 5
    },
    "sms": null
  },
  "method": "prefix"
}

Read from the live API as this page was served. Route identifiers are left out here.

Marketplace data

Prices from the routes that would carry it

Lookup prices a number with the same logic the marketplace uses to bill, across every live public route, so the figure is the one you would pay today.

Pricing

Free, with a fair limit

Lookups cost nothing and need no account. Each caller can run 60 a minute, and every answer is cached for 10 minutes because nothing in it changes minute to minute.

Per lookup
Free
Account needed
No
Rate limit
60 a minute per caller
Cheapest call to the sample number5 routes serve it, live
$0.0260 a minute

In production

Built for production

An answer in one request, before you spend anything on the number.

  • Free, with no accountLookups cost nothing and need no key, at 60 a minute per caller.
  • The price in the same answerThe cheapest public voice and SMS route for that exact number, at the rate it would bill.
  • Type with a confidence scoreNumber type is a weighted vote across every live route deck for the longest matching prefix, returned with its confidence.
  • Network names you can trustA network name is returned only when at least three different sellers agree on it, with the likely mobile network from range data alongside.
  • Every field, every timeValidity, the E.164 and international formats, country, type, network and risk flags in one answer, with no add-on packages to request.

Coming from Twilio

The names you know, mapped

If you have built on Twilio, most of what you know carries over. These are the pieces that change for this product.

TwilioGET /v2/PhoneNumbers/{number}HereGET /lookup/{number}Free, with validity, country and format in every answer.
TwilioLine Type IntelligenceHerenumberType and networkFrom the numbering plan and live route decks, with a confidence score.
TwilioFields parameter for add-onsHereEvery field, every timeNo extra packages to request.

Twilio is a trademark of Twilio Inc. PacketExchange is not affiliated with or endorsed by Twilio.

Questions

Lookup, answered

Is it really free?
Yes. Lookups need no account and cost nothing. Each caller can run 60 a minute.
Where do the answers come from?
From the rate decks of live routes and the number-range data for mobile networks, so an answer is instant and free. The network shown is the one the number range was allocated to.
How accurate is the number type?
It is a weighted vote across every live route's deck for the longest matching prefix, returned with a confidence score. A bare country row does not vote.
Why is the operator sometimes empty?
A network name is only returned when at least three different sellers' decks agree on it. The likely mobile network from range data is returned separately.
Which prices does it show?
The cheapest public voice and SMS route for that exact number, at the rate it would bill, before the platform fee.

Look up your first number now

No account needed for lookups. Sign up when you are ready to send or call, with an API key on sign-up.

Prefer to talk it through? Contact the team.