Phone number validation & lookup API

Validate and parse a phone number (Google's libphonenumber): validity, line type (mobile/landline/VoIP/toll-free), country, and E.164/national/international formats. The same capability as Twilio Lookup. Answers 'is this phone number valid', 'what country is this number', 'is this a mobile number', 'format this to E.164'.

Price$0.01per request

MethodPOST

Route/v1/identity/phone

StatusLive

MIME typeapplication/json

Rate limit90/minute

CacheNo cache

identityphonevalidationlibphonenumbere164mobilelookupkyc

API URLhttps://x402.hexl.dev/v1/identity/phone

Integration docs

Example request

{
  "number": "+1 415 555 2671"
}

Example response

{
  "input": "+1 415 555 2671",
  "valid": true,
  "possible": true,
  "type": "FIXED_LINE_OR_MOBILE",
  "country": "US",
  "countryCallingCode": "+1",
  "nationalNumber": "4155552671",
  "e164": "+14155552671",
  "international": "+1 415 555 2671",
  "national": "(415) 555-2671"
}

Input schema

{
  "type": "object",
  "required": [
    "number"
  ],
  "properties": {
    "number": {
      "type": "string",
      "examples": [
        "+14155552671"
      ]
    },
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 default for national-format input",
      "examples": [
        "US"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "input",
    "valid"
  ],
  "properties": {
    "input": {
      "type": "string"
    },
    "valid": {
      "type": "boolean"
    },
    "possible": {
      "type": "boolean"
    },
    "type": {
      "type": [
        "string",
        "null"
      ]
    },
    "country": {
      "type": [
        "string",
        "null"
      ]
    },
    "countryCallingCode": {
      "type": [
        "string",
        "null"
      ]
    },
    "nationalNumber": {
      "type": [
        "string",
        "null"
      ]
    },
    "e164": {
      "type": [
        "string",
        "null"
      ]
    },
    "international": {
      "type": [
        "string",
        "null"
      ]
    },
    "national": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}