Validate & Format (query params)
Validate and format a phone number supplied via query parameters.
Provide number alone if it is already in international +E.164 form (e.g. +14155552671), or add a country hint (ISO 3166-1 alpha-2, e.g. US, GB, TR) to parse a local-format number such as (415) 555-2671.
The response is always well-formed: genuinely unparseable input returns { "valid": false, "possible": false } with HTTP 200. A 400 is returned only when the required number parameter is missing.
query Parameters
numberThe phone number. May be E.164 (e.g. +14155552671) or a local format (e.g. (415) 555-2671) when a country is supplied.
countryOptional ISO 3166-1 alpha-2 region used as the default country when the number is not in +E.164 form (e.g. US, GB, TR).
Validate & Format (query params) › Responses
Validation result (well-formed even for invalid numbers)
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: input, valid, possible | |
| type = object · requires: input, valid, possible |
inputThe original number string as received.
validWhether the number is fully valid for its detected region.
possibleWhether the number has a plausible length and shape for its region.
e164Canonical international E.164 form.
nationalNumber formatted the way locals write it.
internationalInternationally formatted display form.
rfc3966RFC3966 tel: URI.
uritel: URI for click-to-call links.
countryDetected ISO 3166-1 alpha-2 country code, or null.
country_calling_codeInternational dialing prefix without the plus sign.
typeLine type (MOBILE, FIXED_LINE, FIXED_LINE_OR_MOBILE, etc.) or null.
is_mobileConvenience flag derived from the line type.
is_fixed_lineConvenience flag derived from the line type.
Validate & Format (JSON body)
Validate and format a phone number supplied via a JSON request body.
Provide number alone if it is already in international +E.164 form, or include a country hint (ISO 3166-1 alpha-2) to parse a local-format number.
Validate & Format (JSON body) › Request Body
numberThe phone number to validate and format.
countryOptional ISO 3166-1 alpha-2 region hint.
Validate & Format (JSON body) › Responses
Validation result
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: input, valid, possible | |
| type = object · requires: input, valid, possible |
inputThe original number string as received.
validWhether the number is fully valid for its detected region.
possibleWhether the number has a plausible length and shape for its region.
e164Canonical international E.164 form.
nationalNumber formatted the way locals write it.
internationalInternationally formatted display form.
rfc3966RFC3966 tel: URI.
uritel: URI for click-to-call links.
countryDetected ISO 3166-1 alpha-2 country code, or null.
country_calling_codeInternational dialing prefix without the plus sign.
typeLine type (MOBILE, FIXED_LINE, FIXED_LINE_OR_MOBILE, etc.) or null.
is_mobileConvenience flag derived from the line type.
is_fixed_lineConvenience flag derived from the line type.