Our international Phone Exchange service validates and formats phone numbers for international direct dialing, while returning line type, country code and geocoding information.
|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.|
Your license key to use the service.
|Varies||Array of InternationalExchangeInfo results. See InternationalExchangeInfo description below.|
Error object indicating why the service could not return a result. See “Errors” page for more information.
The phone number that was provided as input.
The country code of the provided phone number.
|The provided phone number in a national format.|
|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|
The latitude of the locality determined from the phone number.
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.|
|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.|