• Our international Phone Exchange service validates and formats phone numbers for international direct dialing, while returning line type, country code and geocoding information.

URL Endpoints

GetInternationalExchangeInfo Inputs

Name Type Description
PhoneNumber String The phone number to be parsed, validated and formatted. The phone number may include extension as well. If no country is provided, the country code should be provided in the phone number.
Country String The Country to be validated using provided phone number. Acceptable Country formats are: ISO2 (Preferred), ISO3, Full Country Name, Variant of Full Country Name, I.P. of region where phone number was collected.
LicenseKey String Your license key to use the service.
Sign up for a free trial key at
https://www.serviceobjects.com/products/phone/phone-exchange

GetInternationalExchangeInfo Outputs

  • InternationalExchangeInfoResponse
Name Type Values Description
InternationalExchangeInfo InternationalExchangeInfo[] Varies Array of InternationalExchangeInfo results. See InternationalExchangeInfo description below.
Error Error Varies Error object indicating why the service could not return a result. See “Errors” page for more information.
  • InternationalExchangeInfo
Name Type Description
PhoneNumberIn String The phone number that was provided as input.
CountryCode String The country code of the provided phone number.
FormatNational String The provided phone number in a national format.
Extension String The parsed extension from the provided phone number.
Locality String The locality from where the phone number belongs. The locality format is generally Locale/Region, Region or Country.
LocalityMatchLevel String The match level that was determined from the locality that was found. Possible values include (Locale/Region, Region, Country) match.
TimeZone String The Time Zone of the validated phone number
Latitude String The latitude of the locality determined from the phone number.
Longitude String The longitude of the locality determined from the phone number.
Country String The country to which the validated phone number belongs.
CountryISO2 String The ISO 2 character country designation for a validated phone number.
CountryISO3 String The ISO 3 character country designation for a validated phone number.
FormatInternational String The provided phone number in international format.
FormatE164 String The provided phone number in E.164 format.
LineType String The linetype determined for the phone number. See InternationalExchangeInfo LineType table below.
SMSAddress String The SMS gateway address for the provided mobile number
MMSAddress String The MMS gateway address for the provided mobile number
IsValid Boolean A boolean response type determining whether the phone number is a valid phone number.
IsValidForRegion Boolean A boolean response type determining whether the phone number is a valid phone number for the provided Country.
NoteCodes String The corresponding codes which match NoteDescriptions. These values vary from 1 to 6 based on test results. See Codes, Notes and Corrections.
NoteDescriptions String The corresponding descriptions which match NoteCodes. These values vary based on NoteCodes. See Codes, Notes and Corrections.

 

Line Types

Name Description
UNKNOWN The line type could not be determined for the given phone number.
PREMIUM_RATE The phone number is assigned at a premium rate. Typically goods or services are charged to the phone number.
TOLL_FREE The phone number is assigned as a toll-free number
SHARED_COST The phone number is assigned as shared cost. A call to this number is shared by the recipient.
VOIP The phone number is registered to a VOIP provider.
PERSONAL_NUMBER The phone number is registered as a personal number.
PAGER The phone number is registered to a pager device.
UAN The phone number is registered as a Universal Access Number.
VOICEMAIL The phone number is registered to a voicemail service.
FIXED_LINE The phone number is registered to a fixed line provider (POTS).
FIXED_LINE_OR_MOBILE The phone number is registered to a carrier that offers Fixed and Mobile services.
MOBILE The phone number is registered to a carrier that offers Mobile services.

 

References