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
| Field | Required | Type | Description |
|---|---|---|---|
phone | Yes | String | Phone number to validate |
countryCode | No | String | ISO country code for local numbers (e.g. DE) |
format | No | String | Expected 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
| Code | Meaning |
|---|---|
phone_correct | Phone number is valid and matches expected format |
phone_needs_correction | Normalized number available in predictions |
phone_invalid | Cannot parse this number |
phone_is_mobile | Mobile/cell number |
phone_is_fixed_line | Landline number |
phone_is_unknown_type | Type cannot be determined |
phone_hlr_lookup_succeeded | Number is active (HLR lookup) |
phone_hlr_lookup_failed | Number is inactive or unreachable |
phone_format_e164 | Input was in E164 format |
phone_format_international | Input was in international format |
phone_format_national | Input was in national format |
phone_format_rfc3966 | Input was in RFC3966 format |
Example
json
{
"jsonrpc": "2.0",
"id": 1,
"method": "phoneCheck",
"params": {
"phone": "+491796862470",
"countryCode": "DE",
"format": "E164"
}
}