Skip to main content
Skip table of contents

International Phone

The International Phone tool validates and standardizes international phone numbers using Google's common Java library for validating and formatting international phone numbers. It accepts a phone number and dialing region as input, and outputs the standardized phone number along with several diagnostic fields.

International Phone tool configuration parameters

The International Phone tool has a single set of configuration parameters in addition to the standard execution options:

Phone field

Input field containing the phone number to be parsed and validated.

Region field

Input field containing the dialing region, expressed as a two-letter  ISO code (GB).

Format

Desired output format for the parsed phone number:

  • INTERNATIONAL number notation uses a leading plus (+) as an international prefix symbol, immediately followed by the country code. Country code, area code, and subscriber number are separated by spaces.
    Example: +22 607 123 4567

  • NATIONAL number notation attempts to use Region field to determine the preferred number format.
    Example: 0115 933 4567

  • RFC3966 numbers conform to the URI scheme "tel"  for phone numbers.
    Example: +22-607-123-4567;ext=101

  • E164 numbers can have a maximum of fifteen digits and are usually written as follows: [+][country code][subscriber number including area code].
    Example: +226071234567

Configure the International Phone tool

  1. Select the International Phone tool, and then go to the Input tab.

  2. Select Phone field and select the input field containing the phone number.

  3. Select Region field and select the input field containing the country/region field.

  4. Select Format and select the desired output format for the parsed phone number.

  5. Optionally, go to the Execution tab, and then set Web service options.

International Phone tool output fields

The International Phone tool outputs two diagnostic fields for each input phone number: phone number type (PHONE_NUM_TYPE), and validation result (VALIDATION_RESULT).

Phone number types

PHONE_NUM_TYPE value

Description

FIXED_LINE

Landline (phone that uses a metal wire or fiber optic telephone line for transmission).

MOBILE

Mobile cellular line.

FIXED_LINE_OR_MOBILE

In some regions (such as the USA), it is impossible to distinguish between fixed-line and mobile numbers by looking at the phone number itself.

TOLL_FREE

Phone number that is billed for all arriving calls instead of incurring charges to the originating  caller.

PREMIUM_RATE

Call in which services are provided. Unlike a normal call, part of the call charge is paid to the service provider. See http://en.wikipedia.org/wiki/Premium-rate_telephone_number.

SHARED_COST

Cost of call is shared between the caller and the recipient, and is typically less than PREMIUM_RATE calls. See http://en.wikipedia.org/wiki/Shared_Cost_Service.

VOIP

Voice over IP numbers, including TSoIP (Telephony Service over IP).

PERSONAL_NUMBER

Number associated with a particular person, and may be routed to either a MOBILE or FIXED_LINE number. See http://en.wikipedia.org/wiki/Personal_Numbers.

PAGER

Number associated with a wireless telecommunications device that receives and displays alphanumeric messages, or receives and announces voice messages.

UAM

"Universal Access Numbers" or "Company Numbers." These may be further routed to specific offices, and allow a single number to be used for a company.

VOICEMAIL

Number associated with a voicemail system.

UNKNOWN

Does not fit any of the known patterns for a specific region.

Validation results

VALIDATION_RESULT value

Description

IS_POSSIBLE

Number length matches that of valid numbers for this region.

IS_POSSIBLE_LOCAL_ONLY

Number length matches that of local numbers for this region only (number that may be able to be dialed within an area, but does not have all the information to be dialed from anywhere inside or outside the country).

INVALID_COUNTRY_CODE

Number has an invalid country calling code.

TOO_SHORT

Number is shorter than all valid numbers for this region.

INVALID_LENGTH

Number is shorter than the longest valid numbers for this region, and does not itself have a number length that matches valid numbers for this region.

TOO_LONG

Number is longer than all valid numbers for this region.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.