Overview
This node parses a given phone number and returns detailed information about it, including country, country calling code, national number, various formatted versions, and validation status. It is useful for workflows that require phone number validation, formatting, or extraction of phone number metadata, such as contact management, CRM integrations, or communication systems.
Use Case Examples
- Validating and formatting user-submitted phone numbers in a form.
- Extracting country and phone type information for analytics or routing calls.
- Cleaning and standardizing phone number data before storing in a database.
Properties
| Name | Meaning |
|---|---|
| Keep Only Set | Whether only the values set on this node should be kept and all others removed |
| Default Country | The default country code used to parse the phone number if the number does not include a country code |
| Phone Number | The phone number to parse, which can be in various formats including international format starting with +. |
Output
JSON
country- The country code of the parsed phone numbercountryCallingCode- The international dialing code of the parsed phone number's countrynationalNumber- The national significant number part of the phone numberformatNational- The phone number formatted in the national formatformatInternational- The phone number formatted in the international formatformatE164- The phone number formatted in E.164 standard formatformatRFC3966- The phone number formatted according to RFC3966 standardpossible- Boolean indicating if the phone number is a possible numbervalid- Boolean indicating if the phone number is a valid numbernonGeographic- Boolean indicating if the phone number is non-geographictype- The type of the phone number (e.g., mobile, fixed line)
Troubleshooting
- If the phone number is invalid or not possible, ensure the input number is correct and includes the country code or the default country is set properly.
- If the node returns empty or incomplete data, verify that the phone number format is supported and the default country is correctly specified.
- Errors related to unsupported country codes may occur if the default country is not a valid ISO country code; ensure the default country is selected from the provided options.
Links
- libphonenumber-js - The library used for parsing and formatting phone numbers