PRODUCTSPHONE VALIDATION
GET /phone
Phone validation.
UK numbers, normalised to E.164 — with carrier and line type.
Parse any UK phone format, return E.164, and classify mobile vs landline vs VoIP vs non-geographic. Live HLR lookup tells you the current carrier — not the number's original range-holder.
GET/phone/%2B447700900123
{
"success": true,
"results": [
{
"number": "+447700900123",
"isValid": true,
"isPossible": true,
"type": "MOBILE",
"countryCode": "GB",
"countryName": "United Kingdom",
"nationalFormat": "07700 900123",
"internationalFormat": "+44 7700 900123",
"e164Format": "+447700900123",
"originalCarrier": "EE Limited",
"currentCarrier": "Vodafone Limited",
"isPorted": true,
"isReachable": "delivered",
"mcc": "234",
"mnc": "15",
"level": "hlr"
}
],
"meta": {
"countResults": 1,
"performance": { "workerMs": 116, "lookupMs": 113 }
}
}USE CASES
Where people use it.
2FA / OTP
Don't send an SMS to a landline — reject non-mobile at signup.
SMS cost control
Mobile-only filter saves wasted sends on invalid or fixed-line numbers.
Delivery ETAs
Normalise driver contact numbers to E.164 before hitting your SMS provider.
CRM hygiene
Deduplicate numbers across inconsistent formats.
RESPONSE SHAPE
Every field, documented.
The full field list is in the API reference. Here's the shape you'll be consuming.
| FIELD | TYPE | EXAMPLE |
|---|---|---|
| number | string | "+447700900123" |
| isValid | boolean | true |
| isPossible | boolean | true |
| type | string | null | "MOBILE" |
| countryCode | string | null | "GB" |
| countryName | string | null | "United Kingdom" |
| nationalFormat | string | null | "07700 900123" |
| internationalFormat | string | null | "+44 7700 900123" |
| e164Format | string | null | "+447700900123" |
| originalCarrier | string | null | "EE Limited" |
| currentCarrier | string | null | "Vodafone Limited" |
| isPorted | boolean | null | true |
| isReachable | string | null | "delivered" |
| mcc | string | null | "234" |
| mnc | string | null | "15" |
| level | string | null | "hlr" |
Ready in under a minute.
Sign up, grab a key, paste it in. Your first hundred lookups are on us.