Global Phone:Response: Difference between revisions

From Melissa Data Wiki
Jump to navigation Jump to search
m Admin moved page Global Phone V4:Response to Global Phone:Response without leaving a redirect
No edit summary
 
(9 intermediate revisions by the same user not shown)
Line 16: Line 16:
{| class="alternate01 sortable"
{| class="alternate01 sortable"
!Field Name !! Level !! JSON
!Field Name !! Level !! JSON
|- style="vertical-align:top;"
|Version||Request||Version
|-
|-
|Transmission Reference||Request||TransmissionReference
|Version||rowspan="4" valign="center"|Response (Base)||Version
|-
|-
|Transmission Results||Request||TransmissionResults
|Transmission Reference||TransmissionReference
|-
|-
|Record ID||Record||RecordID
|Transmission Results||TransmissionResults
|-
|-
|Results||Record||Results
|Total Records||TotalRecords
|-
|-
|Phone Number||Record||PhoneNumber
|Record ID||rowspan="24" valign="center"|Record||RecordID
|-
|-
|Administrative Area||Record||AdministrativeArea
|Results||Results
|-
|-
|Country Abbreviation||Record||CountryAbbreviation
|Phone Number||PhoneNumber
|-
|-
|Country Name||Record||CountryName
|Administrative Area||AdministrativeArea
|-
|-
|Carrier||Record||Carrier
|Country Abbreviation||CountryAbbreviation
|-
|-
|Daylight Savings Time||Record||DST
|Country Name||CountryName
|-
|-
|Language||Record||Language
|Carrier||Carrier
|-
|-
|Latitude||Record||Latitude
|Caller ID||CallerID
|-
|-
|Longitude||Record||Longitude
|Daylight Savings Time||DST
|-
|-
|Locality||Record||Locality
|International Phone Number||InternationalPhoneNumber
|-
|-
|International Prefix||Record||PhoneInternationalPrefix
|Language||Language
|-
|-
|Country Dialing Code||Record||PhoneCountryDialingCode
|Latitude||Latitude
|-
|-
|Nation Prefix||Record||PhoneNationPrefix
|Locality||Locality
|-
|-
|National Destination Code||Record||PhoneNationalDestinationCode
|Longitude||Longitude
|-
|-
|Subscriber Number||Record||PhoneSubscriberNumber
|International Prefix||PhoneInternationalPrefix
|-
|-
|Universal Time Code||Record||UTC
|Country Dialing Code||PhoneCountryDialingCode
|-
|-
|Suggestions||Record||Suggestions
|Nation Prefix||PhoneNationPrefix
|-
|National Destination Code||PhoneNationalDestinationCode
|-
|Subscriber Number||PhoneSubscriberNumber
|-
|Universal Time Code||UTC
|-
|Postal Code||PostalCode
|-
|Suggestions||Suggestions
|-
|Time Zone Code||TimeZoneCode
|-
|Time Zone Name||TimeZoneName
|}
|}


Line 66: Line 78:
The following elements are the basic options for each request. These apply to the entire response, not the individual records.
The following elements are the basic options for each request. These apply to the entire response, not the individual records.


<h3 style="background-color:rgb240,240,240;">Version</h3>
<h3 style="background-color:rgb(240,240,240);">Version</h3>
:This is a string value that is the current revision number of Global Phone.
:This is a string value that is the current revision number of Global Phone.


Line 72: Line 84:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“Version”:”string”
|JSON||<code>"Version":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Transmission Reference</h3>
<h3 style="background-color:rgb(240,240,240);">Transmission Reference</h3>
:This is a string value that serves as a unique identifier for this set of records. It is returned as sent by the Request Array, allowing you to match the Response to the Request.
:This is a string value that serves as a unique identifier for this set of records. It is returned as sent by the Request Array, allowing you to match the Response to the Request.


Line 82: Line 94:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“TransmissionReference”:”string”
|JSON||<code>"TransmissionReference":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Transmission Results</h3>
<h3 style="background-color:rgb(240,240,240);">Transmission Results</h3>
:This is a string value that lists error codes from any errors caused by the most recent request as a whole.
:This is a string value that lists error codes from any errors caused by the most recent request as a whole.


Line 94: Line 106:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“TransmissionResults”:”string”
|JSON||<code>"TransmissionResults":"'''''string'''''"</code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">Total Records</h3>
:Displays the total number of records returned.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"TotalRecords":"'''''string'''''"</code>
|}
|}


Line 110: Line 132:




<h3 style="background-color:rgb240,240,240;">Record ID</h3>
<h3 style="background-color:rgb(240,240,240);">Record ID</h3>
:This is a string value that is a unique identifier for the current record if one was sent in the request. Use this element to match a request record and the corresponding response record.
:This is a string value that is a unique identifier for the current record if one was sent in the request. Use this element to match a request record and the corresponding response record.


Line 116: Line 138:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“RecordID”:”string”
|JSON||<code>"RecordID":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Results</h3>
<h3 style="background-color:rgb(240,240,240);">Results</h3>
:This is a string value with comma delimited status, error codes, and change codes for the record.
:This is a string value with comma delimited status, error codes, and change codes for the record.


Line 128: Line 150:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“Results”:”string”
|JSON||<code>"Results":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Phone Number</h3>
<h3 style="background-color:rgb(240,240,240);">Phone Number</h3>
:This is a string value of the standardized phone number after a successful call to the service.
:This is a string value of the standardized phone number after a successful call to the service.


Line 175: Line 197:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“PhoneNumber”:”string”
|JSON||<code>"PhoneNumber":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Administrative Area</h3>
<h3 style="background-color:rgb(240,240,240);">Administrative Area</h3>
:This is a string that returns the administrative area associated with the inputted phone number.
:This is a string that returns the administrative area associated with the inputted phone number.


Line 187: Line 209:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“AdministrativeArea”:”string”
|JSON||<code>"AdministrativeArea":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Country Abbreviation</h3>
<h3 style="background-color:rgb(240,240,240);">Country Abbreviation</h3>
:This is a string that returns the abbreviation of the country for the inputted phone number.
:This is a string that returns the abbreviation of the country for the inputted phone number.


Line 197: Line 219:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“CountryAbbreviation”:”string”
|JSON||<code>"CountryAbbreviation":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Country Name</h3>
<h3 style="background-color:rgb(240,240,240);">Country Name</h3>
:This is a string that returns the name of the country for the inputted phone number.
:This is a string that returns the name of the country for the inputted phone number.


Line 209: Line 231:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“CountryName”:”string”
|JSON||<code>"CountryName":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Carrier</h3>
<h3 style="background-color:rgb(240,240,240);">Carrier</h3>
:This is a string that returns the name of the phone’s carrier.
:This is a string that returns the name of the phone’s carrier.


Line 219: Line 241:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“Carrier”:”string”
|JSON||<code>"Carrier":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Daylight Savings Time</h3>
<h3 style="background-color:rgb(240,240,240);">Caller ID</h3>
:This is the result from our CallerID service, which it appends the name to the targeted phone number.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"CallerID":"'''''string'''''"</code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">Daylight Savings Time</h3>
:This is a string that returns a ‘Y’ (for yes) or ‘N’ (for no) to distinguish whether the region of the inputted phone number observes daylight savings time.
:This is a string that returns a ‘Y’ (for yes) or ‘N’ (for no) to distinguish whether the region of the inputted phone number observes daylight savings time.


Line 231: Line 263:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“DST”:”string”
|JSON||<code>"DST":"'''''string'''''"</code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">International Phone Number</h3>
:This is the number you would dial, given your output fields, in order to successfully send a call.
 
:This number can change based on whether a Country of Origin is submitted or not.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"InternationalPhoneNumber":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Language</h3>
<h3 style="background-color:rgb(240,240,240);">Language</h3>
:This is a string that returns the predominant language of the phone’s detected geographical location.
:This is a string that returns the predominant language of the phone’s detected geographical location.


:The field will return the written out form of the language name. For example: “French”.
:The field will return the written out form of the language name. For example: "French".


:Because of phone number portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
:Because of phone number portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
Line 245: Line 289:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“Language”:”string”
|JSON||<code>"Language":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Latitude</h3>
<h3 style="background-color:rgb(240,240,240);">Latitude</h3>
:This is a string that returns the latitude of the geographically identifiable service area of the exchange.
:This is a string that returns the latitude of the geographically identifiable service area of the exchange.


Line 259: Line 303:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“Latitude”:”string”
|JSON||<code>"Latitude":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Longitude</h3>
<h3 style="background-color:rgb(240,240,240);">Locality</h3>
:This is a string that returns the longitude of the geographically identifiable service area of the exchange.
:This is a string that returns the locality (city) associated with the phone number passed to the Lookup function.


:Longitude is the geographic coordinate of the locale, city, municipality, or other geographically identifiable service area of the exchange measured in degrees east or west of the Greenwich Meridian.
:Because of phone portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
 
:Because of phone number portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.


:{| class="alternate01"
:{| class="alternate01"
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“Longitude”:”string”
|JSON||<code>"Locality":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Locality</h3>
<h3 style="background-color:rgb(240,240,240);">Longitude</h3>
:This is a string that returns the locality (city) associated with the phone number passed to the Lookup function.
:This is a string that returns the longitude of the geographically identifiable service area of the exchange.
 
:Longitude is the geographic coordinate of the locale, city, municipality, or other geographically identifiable service area of the exchange measured in degrees east or west of the Greenwich Meridian.


:Because of phone portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
:Because of phone number portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.


:{| class="alternate01"
:{| class="alternate01"
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“Locality”:”string”
|JSON||<code>"Longitude":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">International Prefix</h3>
<h3 style="background-color:rgb(240,240,240);">International Prefix</h3>
:This is a string value that returns the international exit code needed to call a number outside of the dialing country.
:This is a string value that returns the international exit code needed to call a number outside of the dialing country.


Line 297: Line 341:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“PhoneInternationalPrefix”:”string”
|JSON||<code>"PhoneInternationalPrefix":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Country Dialing Code</h3>
<h3 style="background-color:rgb(240,240,240);">Country Dialing Code</h3>
:This is a string that returns a digit, or combination of digits, known as the country dialing code.
:This is a string that returns a digit, or combination of digits, known as the country dialing code.


Line 309: Line 353:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“PhoneCountryDialingCode”:”string”
|JSON||<code>"PhoneCountryDialingCode":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Nation Prefix</h3>
<h3 style="background-color:rgb(240,240,240);">Nation Prefix</h3>
:This is a string that returns a digit, or combination of digits, known as the national prefix.
:This is a string that returns a digit, or combination of digits, known as the national prefix.


Line 323: Line 367:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“PhoneNationPrefix”:”string”
|JSON||<code>"PhoneNationPrefix":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">National Destination Code</h3>
<h3 style="background-color:rgb(240,240,240);">National Destination Code</h3>
:This is a string that returns a digit, or combination of digits, known as the national destination code.
:This is a string that returns a digit, or combination of digits, known as the national destination code.


Line 335: Line 379:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“PhoneNationalDestinationCode”:”string”
|JSON||<code>"PhoneNationalDestinationCode":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Subscriber Number</h3>
<h3 style="background-color:rgb(240,240,240);">Subscriber Number</h3>
:This is string that returns the subscriber number associated with the phone number passed in.
:This is string that returns the subscriber number associated with the phone number passed in.


Line 349: Line 393:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“PhoneSubscriberNumber”:”string”
|JSON||<code>"PhoneSubscriberNumber":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Universal Time Code</h3>
<h3 style="background-color:rgb(240,240,240);">Universal Time Code</h3>
:This is a string that returns the universal time code for the time zone associated with the inputted phone number.
:This is a string that returns the universal time code for the time zone associated with the inputted phone number.


Line 363: Line 407:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“UTC”:”string”
|JSON||<code>"UTC":"'''''string'''''"</code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">Postal Code</h3>
:The zip code that corresponds to a locality inside the United States.
 
:Since this is US only, all other countries will have PostalCode blank.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"PostalCode":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb240,240,240;">Suggestions</h3>
<h3 style="background-color:rgb(240,240,240);">Suggestions</h3>
:This is an array of Response Record Elements. This can only be returned for single-record requests.
:This is an array of Response Record Elements. This can only be returned for single-record requests.


Line 373: Line 429:
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||“Suggestions”:”string”
|JSON||<code>"Suggestions":"'''''string'''''"</code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">Time Zone Code</h3>
:This is a string that returns the time zone code for the time zone associated with the inputted phone number. Time zone codes are a 3 letter codes for the locality of the region.
 
:Because of phone number portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"TimeZoneCode":"'''''string'''''"</code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">Time Zone Name</h3>
:This is a string that returns the time zone name associated with the inputted phone number. The name is the full name of the 3 letter time zone code.
 
:Because of phone number portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"TimeZoneName":"'''''string'''''"</code>
|}
|}



Latest revision as of 00:43, 6 March 2018

← Global Phone

Global Phone Navigation
Introduction
Licensing
Input/Output
Request Fields
Response Fields
Examples
REST JSON
Batch JSON
Result Codes
Result Code Use
Global Phone Result Codes
Sample Code



A response is the result of a request. This consists of returned results codes, parsed phone elements, and appended geographic information.

Depending on the protocol used to make the request, the response will be in a certain protocol. Global Phone supports JSON and REST protocols.


Field Names

This is a list of the response field names and their protocol naming conventions.

Field Name Level JSON
Version Response (Base) Version
Transmission Reference TransmissionReference
Transmission Results TransmissionResults
Total Records TotalRecords
Record ID Record RecordID
Results Results
Phone Number PhoneNumber
Administrative Area AdministrativeArea
Country Abbreviation CountryAbbreviation
Country Name CountryName
Carrier Carrier
Caller ID CallerID
Daylight Savings Time DST
International Phone Number InternationalPhoneNumber
Language Language
Latitude Latitude
Locality Locality
Longitude Longitude
International Prefix PhoneInternationalPrefix
Country Dialing Code PhoneCountryDialingCode
Nation Prefix PhoneNationPrefix
National Destination Code PhoneNationalDestinationCode
Subscriber Number PhoneSubscriberNumber
Universal Time Code UTC
Postal Code PostalCode
Suggestions Suggestions
Time Zone Code TimeZoneCode
Time Zone Name TimeZoneName


Response Elements

The following elements are the basic options for each request. These apply to the entire response, not the individual records.

Version

This is a string value that is the current revision number of Global Phone.
Protocol Syntax
JSON "Version":"string"


Transmission Reference

This is a string value that serves as a unique identifier for this set of records. It is returned as sent by the Request Array, allowing you to match the Response to the Request.
Protocol Syntax
JSON "TransmissionReference":"string"


Transmission Results

This is a string value that lists error codes from any errors caused by the most recent request as a whole.
For a complete list of error codes, see Global Phone Result Codes.
Protocol Syntax
JSON "TransmissionResults":"string"


Total Records

Displays the total number of records returned.
Protocol Syntax
JSON "TotalRecords":"string"


Response Record Elements

JSON will only contain the Records element.

Protocol Definition
JSON Each phone number will be contained within [{}] under the Records element.

Each of the following elements are returned for each record in the Response Array.


Record ID

This is a string value that is a unique identifier for the current record if one was sent in the request. Use this element to match a request record and the corresponding response record.
Protocol Syntax
JSON "RecordID":"string"


Results

This is a string value with comma delimited status, error codes, and change codes for the record.
For a complete list of codes, see Global Phone Result Codes.
Protocol Syntax
JSON "Results":"string"


Phone Number

This is a string value of the standardized phone number after a successful call to the service.
The phone number will return in varying formats depending on the inputs. If the inputted country and country of origin are the same the returned number will include the National Destination Code + Subscriber Number. For example:
Input Phone Input Country Input Country of Origin Phone Returned
495-728-5802 RU RU 495-728-5802
+7 495-728-5802 RU RU 495-728-5802
+1 495-728-5802 RU RU 495-728-5802
If the inputted country and country of origin differ, the returned number will include a leading ‘+’ followed by the Country Code + National Destination Code + Subscriber Number. The leading ‘+’ represents the International Prefix that is required to dial a number outside of the caller’s country. For example:
Input Phone Input Country Input Country of Origin Phone Returned
495-728-5802 RU US +7 495-728-5802
+7 495-728-5802 RU US +7 495-728-5802
+1 495-728-5802 RU US +7 495-728-5802
If a country is entered and a country of origin is left blank or not passed in, the returned number will match the format of the inputted phone number. For example:
Input Phone Input Country Input Country of Origin Phone Returned
495-728-5802 RU <blank> 495-728-5802
+7 495-728-5802 RU <blank> +7 495-728-5802
+1 495-728-5802 RU <blank> +7 495-728-5802


Protocol Syntax
JSON "PhoneNumber":"string"


Administrative Area

This is a string that returns the administrative area associated with the inputted phone number.
Because of phone number portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
Protocol Syntax
JSON "AdministrativeArea":"string"


Country Abbreviation

This is a string that returns the abbreviation of the country for the inputted phone number.
Protocol Syntax
JSON "CountryAbbreviation":"string"


Country Name

This is a string that returns the name of the country for the inputted phone number.
Because of phone number portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
Protocol Syntax
JSON "CountryName":"string"


Carrier

This is a string that returns the name of the phone’s carrier.
Protocol Syntax
JSON "Carrier":"string"


Caller ID

This is the result from our CallerID service, which it appends the name to the targeted phone number.
Protocol Syntax
JSON "CallerID":"string"


Daylight Savings Time

This is a string that returns a ‘Y’ (for yes) or ‘N’ (for no) to distinguish whether the region of the inputted phone number observes daylight savings time.
Because of phone number portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
Protocol Syntax
JSON "DST":"string"


International Phone Number

This is the number you would dial, given your output fields, in order to successfully send a call.
This number can change based on whether a Country of Origin is submitted or not.
Protocol Syntax
JSON "InternationalPhoneNumber":"string"


Language

This is a string that returns the predominant language of the phone’s detected geographical location.
The field will return the written out form of the language name. For example: "French".
Because of phone number portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
Protocol Syntax
JSON "Language":"string"


Latitude

This is a string that returns the latitude of the geographically identifiable service area of the exchange.
Latitude is the geographic coordinate of the locale, city, municipality, or other geographically identifiable service area of the exchange measured in degrees north or south of the equator.
Because of phone number portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
Protocol Syntax
JSON "Latitude":"string"


Locality

This is a string that returns the locality (city) associated with the phone number passed to the Lookup function.
Because of phone portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
Protocol Syntax
JSON "Locality":"string"


Longitude

This is a string that returns the longitude of the geographically identifiable service area of the exchange.
Longitude is the geographic coordinate of the locale, city, municipality, or other geographically identifiable service area of the exchange measured in degrees east or west of the Greenwich Meridian.
Because of phone number portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
Protocol Syntax
JSON "Longitude":"string"


International Prefix

This is a string value that returns the international exit code needed to call a number outside of the dialing country.
If the input country and country of origin differ, this will return the digit(s) required to be dialed before the country code.
Protocol Syntax
JSON "PhoneInternationalPrefix":"string"


Country Dialing Code

This is a string that returns a digit, or combination of digits, known as the country dialing code.
This will return the digit(s) dialed after the international prefix.
Protocol Syntax
JSON "PhoneCountryDialingCode":"string"


Nation Prefix

This is a string that returns a digit, or combination of digits, known as the national prefix.
The national prefix must be dialed before an area (city) code when calling a number within the same country but outside the numbering area.
For example (US phone number): 1-949-589-5200 where 1 is the national prefix.
Protocol Syntax
JSON "PhoneNationPrefix":"string"


National Destination Code

This is a string that returns a digit, or combination of digits, known as the national destination code.
The national destination code that identifies a numbering area within a country (or group of countries) and/or network/services.
Protocol Syntax
JSON "PhoneNationalDestinationCode":"string"


Subscriber Number

This is string that returns the subscriber number associated with the phone number passed in.
The subscriber number contains significant leading digits that further define the local exchange area and/or service.
Because of phone number portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
Protocol Syntax
JSON "PhoneSubscriberNumber":"string"


Universal Time Code

This is a string that returns the universal time code for the time zone associated with the inputted phone number.
UTC returns the time zone specified with the format: +/- hh:mm.
Because of phone number portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
Protocol Syntax
JSON "UTC":"string"


Postal Code

The zip code that corresponds to a locality inside the United States.
Since this is US only, all other countries will have PostalCode blank.
Protocol Syntax
JSON "PostalCode":"string"


Suggestions

This is an array of Response Record Elements. This can only be returned for single-record requests.
Protocol Syntax
JSON "Suggestions":"string"


Time Zone Code

This is a string that returns the time zone code for the time zone associated with the inputted phone number. Time zone codes are a 3 letter codes for the locality of the region.
Because of phone number portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
Protocol Syntax
JSON "TimeZoneCode":"string"


Time Zone Name

This is a string that returns the time zone name associated with the inputted phone number. The name is the full name of the 3 letter time zone code.
Because of phone number portability, geographical information may not reflect the true location of the owner of the phone number for wireless and VOIP numbers.
Protocol Syntax
JSON "TimeZoneName":"string"