Skip to content

Phone Check

Validate phone numbers, detect type (mobile/landline), and normalize to standard formats.

Method: phoneCheck

API KeyNot set

Stored in localStorage — never sent to this site.

Parameters
Request Preview
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "phoneCheck",
  "params": {}
}
Set an API key above to enable live requests.

Parameters

FieldRequiredTypeDescription
phoneYesStringPhone number to validate
countryCodeNoStringISO country code for local numbers (e.g. DE)
formatNoStringExpected format: E164, INTERNATIONAL, NATIONAL, RFC3966

Response

json
{
  "result": {
    "original": {
      "phone": "09316639839"
    },
    "predictions": [
      {
        "phone": "+4993166398390",
        "formatNational": "0931 66398390",
        "formatInternational": "+49 931 66398390",
        "formatE164": "+4993166398390",
        "formatRFC3966": "tel:+49-931-66398390",
        "region": "Würzburg",
        "carrier": "",
        "countryPrefix": "+49",
        "nationalNumber": "93166398390",
        "nationalPrefix": "0931",
        "nationalBody": "66398390",
        "leadingZeros": 1
      }
    ],
    "status": [
      "phone_is_fixed_line",
      "phone_needs_correction"
    ]
  }
}

Status Codes

CodeMeaning
phone_correctPhone number is valid and matches expected format
phone_needs_correctionNormalized number available in predictions
phone_invalidCannot parse this number
phone_is_mobileMobile/cell number
phone_is_fixed_lineLandline number
phone_is_unknown_typeType cannot be determined
phone_hlr_lookup_succeededNumber is active (HLR lookup)
phone_hlr_lookup_failedNumber is inactive or unreachable
phone_format_e164Input was in E164 format
phone_format_internationalInput was in international format
phone_format_nationalInput was in national format
phone_format_rfc3966Input was in RFC3966 format

Example

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "phoneCheck",
  "params": {
    "phone": "+491796862470",
    "countryCode": "DE",
    "format": "E164"
  }
}

Endereco JSON-RPC API