Number Lookup
Identify a phone number's country and mobile network before dialing/texting it - free, static prefix lookup, real limitations explained.
Number Lookup
Identify which country and mobile network a phone number belongs to before you dial or text it — useful for validating a number at signup, or checking it's worth spending a Phone Verification send on before you try. Try it free with no login at 6xcom.com/carrier-lookup.
POST /api/v1/lookup/number
| Field | Type | Required | Description |
|---|---|---|---|
| number | string | Yes | Phone number, ideally in international format e.g. +2348011234567 |
Example request
curl -X POST https://app.6xcom.com/api/v1/lookup/number \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"number":"+447936508801"}'Response
{
"found": true,
"confident": true,
"matches": [
{
"country": "United Kingdom",
"country_name": "United Kingdom",
"flag": "🇬🇧",
"dial_code": "+44",
"network": "Three",
"mcc": "234",
"operators": ["Three", "O2"]
}
]
}When confident is false, matches contains more than one entry — the number had no unambiguous country code (e.g. you submitted it without a leading + or country code), so every real possibility is returned rather than 6X guessing one for you.
Important limitation — read this before relying on it
This is static prefix/operator identification — which network a number was originally assigned to — not a live reachability or "is this number active right now" check. Because of mobile number portability, a number can move to a different network than its prefix suggests. If you need to know whether a number is genuinely live and reachable right now, use a Flash-Call Reachability Check (wholesale accounts) or Phone Verification (any business — actually gets the customer to prove it by entering a code).
Billing
Free — this is a local data lookup with no carrier involved, so there's no cost to pass on.
Error codes
| Status | Meaning |
|---|---|
| 401 | Missing or invalid API token |
| 403 | Account inactive, or the API Access addon isn't enabled on your account |
| 422 | Missing or malformed number field |
| 429 | Rate limit exceeded (60 requests/minute), or your account's daily API call limit (10,000/day) is reached |