osint_phone_validator
Parse and validate phone numbers to extract E.164, international, national, and tel URI formats, plus detected country, number type, and carrier hints. Uses offline rule-based validation.
Instructions
Phone Number Validator and Formatter. Parse and validate a phone number, returning E.164, international, national, and RFC3966 (tel URI) formats plus the detected country, ITU-T number type (geographic/mobile/toll_free/premium_rate/special_service), and best-effort carrier and timezone notes. Validation is offline and rule-based: it checks 7-15 digit ITU-T E.164 length and matches a built-in table of about 20 country calling codes (no live HLR or carrier lookup and no third-party request), so carrier and ported fields are heuristic, not network-confirmed. Use osint_iban_validator, osint_bic_swift_validator, or osint_credit_card_validator instead for bank or card identifiers. Read-only, non-destructive, rate-limited (20 requests/minute for anonymous callers). Returns a result object with valid, formats, country_info, type, and warnings.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| phone_number | Yes | Phone number to validate; may include a leading plus, spaces, dashes, or parentheses (all stripped to digits). Provide E.164 form (country code first) for reliable country detection. Must not be blank. | |
| country_code | No | Optional ISO country hint (for example US, GB, DE) used to pick the country when the number has no leading calling code. Empty string means auto-detect from the digits. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| success | No | Whether validation ran; false with an error string on blank or failed input. | |
| error | No | Human-readable failure reason; present only when success is false. | |
| result | No | Validation detail, present only when success is true. |