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 }
  }
}
● 200 OK·38MS
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.

FIELDTYPEEXAMPLE
numberstring"+447700900123"
isValidbooleantrue
isPossiblebooleantrue
typestring | null"MOBILE"
countryCodestring | null"GB"
countryNamestring | null"United Kingdom"
nationalFormatstring | null"07700 900123"
internationalFormatstring | null"+44 7700 900123"
e164Formatstring | null"+447700900123"
originalCarrierstring | null"EE Limited"
currentCarrierstring | null"Vodafone Limited"
isPortedboolean | nulltrue
isReachablestring | null"delivered"
mccstring | null"234"
mncstring | null"15"
levelstring | null"hlr"

Ready in under a minute.

Sign up, grab a key, paste it in. Your first hundred lookups are on us.