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"const res = await fetch('https://packetexchange.io/api/v1/lookup/447911123456');
const { data } = await res.json();
if (!data.valid || data.risk.blocked || data.risk.highRisk) {
throw new Error('Do not send to this number');
}
console.log(data.country.name, data.numberType, data.pricing.sms?.rate);import httpx
data = httpx.get("https://packetexchange.io/api/v1/lookup/447911123456").json()["data"]
if not data["valid"] or data["risk"]["blocked"] or data["risk"]["highRisk"]:
raise ValueError("Do not send to this number")
print(data["country"]["name"], data["numberType"], (data["pricing"]["sms"] or {}).get("rate"))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.
Twilio is a trademark of Twilio Inc. PacketExchange is not affiliated with or endorsed by Twilio.
Questions
Lookup, answered
Is it really free?
Where do the answers come from?
How accurate is the number type?
Why is the operator sometimes empty?
Which prices does it show?
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.

