Personator Identity:Response: Difference between revisions

From Melissa Data Wiki
Jump to navigation Jump to search
← Older edit
No edit summary
No edit summary
 
(20 intermediate revisions by the same user not shown)
Line 25: Line 25:
|Version || Version
|Version || Version
|-
|-
|Results ||rowspan="7" valign="center"| Identity || Results
|Results ||rowspan="9" valign="center"| Identity || Results
|-
|-
|Confidence || Confidence
|Confidence || Confidence
Line 38: Line 38:
|-
|-
|Date of birth || DateOfBirth
|Date of birth || DateOfBirth
|-
|Account Number || AccountNumber
|-
|Business Information || BusinessInformation
|-
|-
|Results ||rowspan="14" valign="center"| Name || Results
|Results ||rowspan="14" valign="center"| Name || Results
Line 45: Line 49:
|Name prefix || NamePrefix
|Name prefix || NamePrefix
|-
|-
|First name || NameFirst
|NameFirst || NameFirst
|-
|-
|Middle name || NameMiddle
|NameMiddle || NameMiddle
|-
|-
|NameLast || NameLast
|NameLast || NameLast
Line 67: Line 71:
|Gender2 || Gender2
|Gender2 || Gender2
|-
|-
|Results ||rowspan="43" valign="center"| Address || Results
|Results ||rowspan="46" valign="center"| Address || Results
|-
|-
|FormattedAddress || FormattedAddress
|FormattedAddress || FormattedAddress
Line 88: Line 92:
|-
|-
|AddressLine8 || AddressLine8
|AddressLine8 || AddressLine8
|-
|SubPremises || SubPremises
|-
|-
|DoubleDependentLocality || DoubleDependentLocality
|DoubleDependentLocality || DoubleDependentLocality
|-
|DependentLocality || DependentLocality
|-
|Locality || Locality
|-
|-
|SubAdministrativeArea || SubAdministrativeArea
|SubAdministrativeArea || SubAdministrativeArea
Line 153: Line 163:
|Longitude || Longitude
|Longitude || Longitude
|-
|-
|Results ||rowspan="7" valign="center"| Email || Results
|Deliverability Confidence Score ||rowspan="26" valign="center"| Email || DeliverabilityConfidenceScore
|-
|Results || Results
|-
|-
|Email address || EmailAddress
|Email address || EmailAddress
Line 167: Line 179:
|Date checked || DateChecked
|Date checked || DateChecked
|-
|-
|Results ||rowspan="19" valign="center"| Phone || Results
|Email Age Estimated || EmailAgeEstimated
|-
|Domain Age Estimated || DomainAgeEstimated
|-
|Domain Expiration Date || DomainExpirationDate
|-
|Domain Created Date || DomainCreatedDate
|-
|Domain Updated Date || DomainUpdatedDate
|-
|Domain Email || DomainEmail
|-
|Domain Organization || DomainOrganization
|-
|Domain Address 1 || DomainAddress1
|-
|Domain Locality || DomainLocality
|-
|Domain Administrative Area || DomainAdministrativeArea
|-
|Domain Postal Code || DomainPostalCode
|-
|Domain Country || DomainCountry
|-
|Domain Availability || DomainAvailability
|-
|Domain Country Code || DomainCountryCode
|-
|Domain Private Proxy || DomainPrivateProxy
|-
|Privacy Flag || PrivacyFlag
|-
|MX Server || MXServer
|-
|Breach Count || BreachCount
|-
|Results ||rowspan="21" valign="center"| Phone || Results
|-
|Phone Number || PhoneNumber
|-
|-
|Carrier || Carrier
|Administrative Area || AdministrativeArea
|-
|-
|Caller ID || CallerID
|Country Abbreviation || CountryAbbreviation
|-
|-
|International phone number || InternationalPhoneNumber
|Country Name || CountryName
|-
|-
|Phone number || PhoneNumber
|Carrier || Carrier
|-
|-
|Phone international prefix || PhoneInternationalPrefix
|Caller ID || CallerID
|-
|-
|Phone nation prefix || PhoneNationPrefix
|Daylight Savings Time || DST
|-
|-
|Phone country dialing code || PhoneCountryDialingCode
|International Phone Number || InternationalPhoneNumber
|-
|-
|Phone national destination code || PhoneNationalDestinationCode
|Language || Language
|-
|-
|Phone subscriber number || PhoneSubscriberNumber
|Latitude || Latitude
|-
|-
|Locality || Locality
|Locality || Locality
|-
|-
|Administrative area ||  
|Longitude || Longitude
|-
|-
|Country name ||  
|International Prefix || PhoneInternationalPrefix
|-
|-
|Country abbreviation ||  
|Country Dialing Code || PhoneCountryDialingCode
|-
|-
|DST ||  
|Nation Prefix || PhoneNationPrefix
|-
|-
|UTC ||  
|National Destination Code || PhoneNationalDestinationCode
|-
|-
|Language ||  
|Subscriber Number || PhoneSubscriberNumber
|-
|-
|Latitude ||  
|Universal Time Code|| UTC
|-
|-
|Longitude ||  
|Postal Code || PostalCode
|-
|Suggestions || Suggestions
|}
|}


Line 212: Line 264:


==Response (Base Level)==
==Response (Base Level)==
<h3 style="background-color:rgb(240,240,240);">TransactionID</h3>
<h3 class="h3grey">TransactionID</h3>
:This is a string value that serves as a unique identifier for this record. A unique transaction ID is generated for every record handled by Personator Identity Verification.
:This is a string value that serves as a unique identifier for this record. A unique transaction ID is generated for every record handled by Personator Identity.


:{| class="alternate01"
:{| class="alternate01"
Line 222: Line 274:




<h3 style="background-color:rgb(240,240,240);">TransmissionReference</h3>
<h3 class="h3grey">TransmissionReference</h3>
:This is a string value that serves as a unique identifier for this request. It is returned as sent in the request, allowing you to match the response to the request.
:This is a string value that serves as a unique identifier for this request. It is returned as sent in the request, allowing you to match the response to the request.


Line 232: Line 284:




<h3 style="background-color:rgb(240,240,240);">Results</h3>
<h3 class="h3grey">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.
For a complete list of error codes, see [[Result Code Details#Personator Identity Verification|Personator Identity Verification Result Codes]].
For a complete list of error codes, see [[Result Code Details#Personator Identity|Personator Identity Result Codes]].


:{| class="alternate01"
:{| class="alternate01"
Line 243: Line 295:




<h3 style="background-color:rgb(240,240,240);">Version</h3>
<h3 class="h3grey">Version</h3>
:This is a string value that is the current revision number of Personator Identity Verification web service.
:This is a string value that is the current revision number of Personator Identity web service.


:{| class="alternate01"
:{| class="alternate01"
Line 254: Line 306:


==Identity==
==Identity==
<h3 style="background-color:rgb(240,240,240);">Results</h3>
<h3 class="h3grey">Results</h3>
:This is a string value that lists the ID verification codes (KV*).
:This is a string value that lists the ID verification codes (KV*).


:For a complete list of ID verification codes, see [[Result Code Details#Personator Identity Verification|Personator Identity Verification Result Codes]].
:For a complete list of ID verification codes, see [[Result Code Details#Personator Identity|Personator Identity Result Codes]].


:{| class="alternate01"
:{| class="alternate01"
Line 266: Line 318:




<h3 style="background-color:rgb(240,240,240);">Confidence</h3>
<h3 class="h3grey">Confidence</h3>
:This is a string value containing a value indicating how reliable the record is after performing ID verification.
:This is a string value containing a value indicating how reliable the record is after performing ID verification.


Line 289: Line 341:




<h3 style="background-color:rgb(240,240,240);">Datasources</h3>
<h3 class="h3grey">Datasources</h3>
:Contains an array of data sources where a match is found against the input. This field is only available when the Verify action is specified. Otherwise a null value is returned.
:Contains an array of data sources where a match is found against the input. This field is only available when the Verify action is specified. Otherwise a null value is returned.


Line 325: Line 377:




<h3 style="background-color:rgb(240,240,240);">Watchlists</h3>
<h3 class="h3grey">Watchlists</h3>
:An object with two fields.
:An object with three fields.


:For a list of used watchlists, see [[Personator Identity Verification:Watchlists|Personator Identity Verification Watchlists]].
:For a list of used watchlists, see [[Personator Identity:Watchlists|Personator Identity Watchlists]].


:{| class="alternate01"
:{| class="alternate01"
!Field !! Meaning
!Field !! Meaning
|-
|-
|Hit||Returns a boolean string containing either true or false.
|Hit||Returns a string containing either <code>Yes</code> or <code>No</code>.
|-
|-
|Sources||Returns an array of the names of watchlists the individual was found on.
|Sources||Returns an array of the names of watchlists the individual was found on.
|-
|Name||A string value containing the name of the Watchlist source that was matched.
|-
|Code||A two letter string representing the code attributed to the watchlist source. Premium Watchlist matches will always return <code>PR</code>.
|-
|Type||A string value containing the type or category of Watchlist that was matched against.
|-
|Date||A string value containing the date (<code>YYYY-MM-DD</code>) of when the Watchlist source was created. An empty string will be returned if the source does not have this information.
|-
|Articles||Returns the title, link and date of the article.
|}
|}


Line 344: Line 406:
|<br>JSON
|<br>JSON
|
|
"Watchlists": {
"Watchlists": {
  "Hit":"'''''string'''''",
  "Hit":"string",
  "Sources":
  "Sources":
    [{
    [{
      "Name":"'''''string'''''"
      "Name":"string",
    }]
      "Code":"string",
  }
      "Type":"string",
      "Date":"string"
    }]
  },
  "Articles":
    [{
      "Title":"string",
      "Link":"string",
      "Date":"string"
    }]
  }
|
|
"Watchlists": {
"Watchlists": {
  "Hit":"true",
  "Hit":"Yes",
  "Sources":  
  "Sources":
    [{
    [{
      "Name":"Specially Designated Nationals (OFAC) (SDN)"
      "Name":"Specially Designated Nationals OFAC",
    },
      "Code":"",
    {
      "Type":"sanction",
      "Name":"UK Consolidated Sanctions"
      "Date":""
    }]
    },
  }
    {
      "Name":"United Kingdom HM Treasury",
      "Code": "PR",
      "Type": "sanction",
      "Date": "2005-12-07"
    }],
  "Articles":
    [{
      "Title":"SampleTitleName",
      "Link":"<nowiki>http://samplereportlink.com</nowiki>",
      "Date":"2017-09-30T00:00:00Z"
    }],
  }
|}
|}




<h3 style="background-color:rgb(240,240,240);">WatchlistsPersons</h3>
<h3 class="h3grey">WatchlistsPersons</h3>
:''Blank (Currently reserved for future)'' – A string value listing the potential names that were found matched on a watchlist.
:''Blank (Currently reserved for future)'' – A string value listing the potential names that were found matched on a watchlist.


Line 375: Line 459:




<h3 style="background-color:rgb(240,240,240);">NationalID</h3>
<h3 class="h3grey">NationalID</h3>
:A string value containing the input national ID returned as is.
:A string value containing the input national ID returned as is.


Line 385: Line 469:




<h3 style="background-color:rgb(240,240,240);">DateOfBirth</h3>
<h3 class="h3grey">DateOfBirth</h3>
:A string value containing the input date of birth returned as is.
:A string value containing the input date of birth returned as is.


Line 392: Line 476:
|-
|-
|JSON||<code>"DateOfBirth":"'''''string'''''"</code>
|JSON||<code>"DateOfBirth":"'''''string'''''"</code>
|}
<h3 class="h3grey">AccountNumber</h3>
:An object that returns one field for account number status.
:{| class="alternate01"
!Field !! Meaning
|-
|Validated||Returns a string containing either <code>Y</code> or <code>N</code>.
|}
:{| class="alternate01"
!Protocol !! Syntax !! Example
|-
|JSON
|<code>"AccountNumber": {<br>
"Validated":"string"<br>
}</code>
|<code>"AccountNumber": {<br>
"Validated":"Y"<br>
}</code>
|}
<h3 class="h3grey">BusinessInformation</h3>
:An object that returns the following Business Information:
:{| class="alternate01"
!Field !! Meaning
|-
|Name||Name of the business that matched
|-
|ID||Business ID. Uses the official business ID specific to the country:
*US: EIN
*SG: Unique Entity Number
*CA: Corporations Number or Business Number
*DE: German Trade Register or Handelsregister (HRB)
|-
|Status||The current status of the business. e.g. "Active".
|-
|Type||Business Type, e.g. "Corporation", "Limited Liability Company".
|-
|Date||Registration Date of the business, in the <code>YYYY-MM-DD</code> format.
|}
:{| class="alternate01"
!Protocol !! Syntax !! Example
|-
|JSON
|<code>"BusinessInformation": {<br>
"Name":"string",<br>
"ID":"string",<br>
"Status":"string",<br>
"Type":"string",<br>
"RegistrationDate":"string"<br>
}</code>
|<code>"BusinessInformation": {<br>
"Name":"Melissa Data",<br>
"ID":"0123456",<br>
"Status":" ",<br>
"Type":"Corporation",<br>
"RegistrationDate":"1985-01-01"<br>
}</code>
|}
|}




==Name==
==Name==
<h3 style="background-color:rgb(240,240,240);">Results</h3>
<h3 class="h3grey">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.


:For a complete list of codes, see [[Result Code Details#Personator Identity Verification|Personator Identity Verification Result Codes]].
:For a complete list of codes, see [[Result Code Details#Personator Identity|Personator Identity Result Codes]].


:{| class="alternate01"
:{| class="alternate01"
Line 408: Line 557:




<h3 style="background-color:rgb(240,240,240);">Company</h3>
<h3 class="h3grey">Company</h3>
:This is a string value of the standardized company name.
:This is a string value of the standardized company name.


Line 418: Line 567:




<h3 style="background-color:rgb(240,240,240);">NamePrefix</h3>
<h3 class="h3grey">NamePrefix</h3>
:This is a string value of the first prefix (such as “Mr.” or “Dr.”) from an inputted full name.
:This is a string value of the first prefix (such as “Mr.” or “Dr.”) from an inputted full name.


Line 430: Line 579:




<h3 style="background-color:rgb(240,240,240);">NameFirst</h3>
<h3 class="h3grey">NameFirst</h3>
:This is a string value of the first name from an inputted full name.
:This is a string value of the first name from an inputted full name.


Line 442: Line 591:




<h3 style="background-color:rgb(240,240,240);">NameMiddle</h3>
<h3 class="h3grey">NameMiddle</h3>
:This is a string value of the middle name from an inputted full name.
:This is a string value of the middle name from an inputted full name.


Line 454: Line 603:




<h3 style="background-color:rgb(240,240,240);">NameLast</h3>
<h3 class="h3grey">NameLast</h3>
:This is a string value of the last name from an inputted full name.
:This is a string value of the last name from an inputted full name.


Line 466: Line 615:




<h3 style="background-color:rgb(240,240,240);">NameSuffix</h3>
<h3 class="h3grey">NameSuffix</h3>
:This is a string value of the first suffix (such as “Jr.” or “III”) from an inputted full name.
:This is a string value of the first suffix (such as “Jr.” or “III”) from an inputted full name.


Line 478: Line 627:




<h3 style="background-color:rgb(240,240,240);">Gender</h3>
<h3 class="h3grey">Gender</h3>
:This is a one-character string value indicating the gender of the first name from the input.
:This is a one-character string value indicating the gender of the first name from the input.


Line 501: Line 650:




<h3 style="background-color:rgb(240,240,240);">NamePrefix2</h3>
<h3 class="h3grey">NamePrefix2</h3>
:This is a string value of the second prefix (such as “Mr.” or “Dr.”) from an inputted full name.
:This is a string value of the second prefix (such as “Mr.” or “Dr.”) from an inputted full name.


Line 513: Line 662:




<h3 style="background-color:rgb(240,240,240);">NameFirst2</h3>
<h3 class="h3grey">NameFirst2</h3>
:This is a string value of the second first name from an inputted full name.
:This is a string value of the second first name from an inputted full name.


Line 525: Line 674:




<h3 style="background-color:rgb(240,240,240);">NameMiddle2</h3>
<h3 class="h3grey">NameMiddle2</h3>
:This is a string value of the second middle name from an inputted full name.
:This is a string value of the second middle name from an inputted full name.


Line 537: Line 686:




<h3 style="background-color:rgb(240,240,240);">NameLast2</h3>
<h3 class="h3grey">NameLast2</h3>
:This is a string value of the second last name from an inputted full name.
:This is a string value of the second last name from an inputted full name.


Line 549: Line 698:




<h3 style="background-color:rgb(240,240,240);">NameSuffix2</h3>
<h3 class="h3grey">NameSuffix2</h3>
:This is a string value of the second suffix (such as “Jr.” or “III”) from an inputted full name.
:This is a string value of the second suffix (such as “Jr.” or “III”) from an inputted full name.


Line 561: Line 710:




<h3 style="background-color:rgb(240,240,240);">Gender2</h3>
<h3 class="h3grey">Gender2</h3>
:This is a one-character string value indicating the gender of the inputted full name.
:This is a one-character string value indicating the gender of the inputted full name.


Line 587: Line 736:


==Address==
==Address==
<h3 style="background-color:rgb(240,240,240);">Results</h3>
<h3 class="h3grey">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.


:For a complete list of codes, see [[Result Code Details#Personator Identity Verification|Personator Identity Verification Result Codes]].
:For a complete list of codes, see [[Result Code Details#Personator Identity|Personator Identity Result Codes]].


:{| class="alternate01"
:{| class="alternate01"
Line 599: Line 748:




<h3 style="background-color:rgb(240,240,240);">FormattedAddress</h3>
<h3 class="h3grey">FormattedAddress</h3>
:This is a string value that is the address in the correct format for mailing from the country specified in the CountryOfOrigin element. This includes the Organization as the first line, one or more lines in the origin country’s format, and the destination country (if required). Separate lines will be delimited by what is specified in the option. See [[Global Address Verification:Request#LineSeparator|LineSeparator]] for more information.
:This is a string value that is the address in the correct format for mailing from the country specified in the CountryOfOrigin element. This includes the Organization as the first line, one or more lines in the origin country’s format, and the destination country (if required). Separate lines will be delimited by what is specified in the option. See [[Global Address Verification:Request#LineSeparator|LineSeparator]] for more information.


Line 609: Line 758:




<h3 style="background-color:rgb(240,240,240);">Organization</h3>
<h3 class="h3grey">Organization</h3>
:This is a string value that matches the Organization request element. It is not modified or populated by the Cloud Service.
:This is a string value that matches the Organization request element. It is not modified or populated by the Cloud Service.


Line 619: Line 768:




<h3 style="background-color:rgb(240,240,240);">AddressLine1</h3>
<h3 class="h3grey">AddressLine1</h3>
:These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
:These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.


Line 629: Line 778:




<h3 style="background-color:rgb(240,240,240);">AddressLine2</h3>
<h3 class="h3grey">AddressLine2</h3>
:These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
:These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.


Line 639: Line 788:




<h3 style="background-color:rgb(240,240,240);">AddressLine3</h3>
<h3 class="h3grey">AddressLine3</h3>
:These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
:These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.


Line 649: Line 798:




<h3 style="background-color:rgb(240,240,240);">AddressLine4</h3>
<h3 class="h3grey">AddressLine4</h3>
:These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
:These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.


Line 659: Line 808:




<h3 style="background-color:rgb(240,240,240);">AddressLine5</h3>
<h3 class="h3grey">AddressLine5</h3>
:These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
:These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.


Line 669: Line 818:




<h3 style="background-color:rgb(240,240,240);">AddressLine6</h3>
<h3 class="h3grey">AddressLine6</h3>
:These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
:These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.


Line 679: Line 828:




<h3 style="background-color:rgb(240,240,240);">AddressLine7</h3>
<h3 class="h3grey">AddressLine7</h3>
:These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
:These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.


Line 689: Line 838:




<h3 style="background-color:rgb(240,240,240);">AddressLine8</h3>
<h3 class="h3grey">AddressLine8</h3>
:These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
:These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.


Line 699: Line 848:




<h3 style="background-color:rgb(240,240,240);">SubPremises</h3>
<h3 class="h3grey">SubPremises</h3>
:This is a string value that is the parsed SubPremises from the AddressLine elements.
:This is a string value that is the parsed SubPremises from the AddressLine elements.


Line 711: Line 860:




<h3 style="background-color:rgb(240,240,240);">DoubleDependentLocality</h3>
<h3 class="h3grey">DoubleDependentLocality</h3>
:This is a string value that is the standardized contents of the DoubleDependentLocality element.
:This is a string value that is the standardized contents of the DoubleDependentLocality element.


Line 721: Line 870:




<h3 style="background-color:rgb(240,240,240);">DependentLocality</h3>
<h3 class="h3grey">DependentLocality</h3>
:This is a string value that is the standardized contents of the DependentLocality element.
:This is a string value that is the standardized contents of the DependentLocality element.


Line 731: Line 880:




<h3 style="background-color:rgb(240,240,240);">Locality</h3>
<h3 class="h3grey">Locality</h3>
:This is a string value that is the standardized contents of the Locality element.
:This is a string value that is the standardized contents of the Locality element.


Line 741: Line 890:




<h3 style="background-color:rgb(240,240,240);">SubAdministrativeArea</h3>
<h3 class="h3grey">SubAdministrativeArea</h3>
:This is a string value that is the standardized contents of the SubAdministrativeArea element.
:This is a string value that is the standardized contents of the SubAdministrativeArea element.


Line 751: Line 900:




<h3 style="background-color:rgb(240,240,240);">AdministrativeArea</h3>
<h3 class="h3grey">AdministrativeArea</h3>
:This is a string value that is the standardized contents of the AdministrativeArea element.
:This is a string value that is the standardized contents of the AdministrativeArea element.


Line 761: Line 910:




<h3 style="background-color:rgb(240,240,240);">PostalCode</h3>
<h3 class="h3grey">PostalCode</h3>
:This is a string value that is the standardized contents of the PostalCode element.
:This is a string value that is the standardized contents of the PostalCode element.


Line 772: Line 921:


==Appended Address Record Elements==
==Appended Address Record Elements==
<h3 style="background-color:rgb(240,240,240);">AddressType</h3>
<h3 class="h3grey">AddressType</h3>
:This is an appended string value that returns a one-character code for the type of address coded. This element works only for US and Canadian addresses.
:This is an appended string value that returns a one-character code for the type of address coded. This element works only for US and Canadian addresses.


Line 782: Line 931:




<h3 style="background-color:rgb(240,240,240);">AddressKey</h3>
<h3 class="h3grey">AddressKey</h3>
:This is a string value that is a unique key for the address. Only for US and Canadian addresses.
:This is a string value that is a unique key for the address. Only for US and Canadian addresses.


Line 794: Line 943:




<h3 style="background-color:rgb(240,240,240);">SubNationalArea</h3>
<h3 class="h3grey">SubNationalArea</h3>
:This is a string value that is the standardized contents of the SubNationalArea element.
:This is a string value that is the standardized contents of the SubNationalArea element.


Line 804: Line 953:




<h3 style="background-color:rgb(240,240,240);">CountryName</h3>
<h3 class="h3grey">CountryName</h3>
:This is a string value that is the standardized contents of the CountryName element.
:This is a string value that is the standardized contents of the CountryName element.


Line 814: Line 963:




<h3 style="background-color:rgb(240,240,240);">CountryCode</h3>
<h3 class="h3grey">CountryCode</h3>
:This is a string value that is the parsed CountryCode element from the input.
:This is a string value that is the parsed CountryCode element from the input.


Line 837: Line 986:




<h3 style="background-color:rgb(240,240,240);">CountryISO3</h3>
<h3 class="h3grey">CountryISO3</h3>
:This is a string value that is the parsed CountryISO3 element from the input.
:This is a string value that is the parsed CountryISO3 element from the input.


Line 860: Line 1,009:




<h3 style="background-color:rgb(240,240,240);">CountryNumber</h3>
<h3 class="h3grey">CountryNumber</h3>
:This is a string value that is the parsed CountryNumber element from the input.
:This is a string value that is the parsed CountryNumber element from the input.


Line 883: Line 1,032:




<h3 style="background-color:rgb(240,240,240);">CountrySubdivisionCode</h3>
<h3 class="h3grey">CountrySubdivisionCode</h3>
:This is the ISO3166-2 code for country subdivisions, usually the administrative area for a country. The format is the 2 letter country code followed by a dash followed by 2 or 3 characters or two numbers. Examples are: US-CA, CN-16, or AU-VIC.
:This is the ISO3166-2 code for country subdivisions, usually the administrative area for a country. The format is the 2 letter country code followed by a dash followed by 2 or 3 characters or two numbers. Examples are: US-CA, CN-16, or AU-VIC.


Line 895: Line 1,044:




<h3 style="background-color:rgb(240,240,240);">Thoroughfare</h3>
<h3 class="h3grey">Thoroughfare</h3>
:This is a string value that is the parsed Thoroughfare element from the input.
:This is a string value that is the parsed Thoroughfare element from the input.


Line 905: Line 1,054:




<h3 style="background-color:rgb(240,240,240);">ThoroughfarePreDirection</h3>
<h3 class="h3grey">ThoroughfarePreDirection</h3>
:This is a string value that is the parsed ThoroughfarePreDirection element from the input.
:This is a string value that is the parsed ThoroughfarePreDirection element from the input.


Line 915: Line 1,064:




<h3 style="background-color:rgb(240,240,240);">ThoroughfareLeadingType</h3>
<h3 class="h3grey">ThoroughfareLeadingType</h3>
:This is a string value that is the parsed ThoroughfareLeadingType element from the input.
:This is a string value that is the parsed ThoroughfareLeadingType element from the input.


Line 925: Line 1,074:




<h3 style="background-color:rgb(240,240,240);">ThoroughfareName</h3>
<h3 class="h3grey">ThoroughfareName</h3>
:This is a string value that is the parsed ThoroughfareName element from the input.
:This is a string value that is the parsed ThoroughfareName element from the input.


Line 935: Line 1,084:




<h3 style="background-color:rgb(240,240,240);">ThoroughfareTrailingType</h3>
<h3 class="h3grey">ThoroughfareTrailingType</h3>
:This is a string value that is the parsed ThoroughfareTrailingType element from the input.
:This is a string value that is the parsed ThoroughfareTrailingType element from the input.


Line 945: Line 1,094:




<h3 style="background-color:rgb(240,240,240);">ThoroughfarePostDirection</h3>
<h3 class="h3grey">ThoroughfarePostDirection</h3>
:This is a string value that is the parsed ThoroughfarePostDirection element from the input.
:This is a string value that is the parsed ThoroughfarePostDirection element from the input.


Line 955: Line 1,104:




<h3 style="background-color:rgb(240,240,240);">DependentThoroughfare</h3>
<h3 class="h3grey">DependentThoroughfare</h3>
:This is a string value that is the parsed DependentThoroughfare element from the input.
:This is a string value that is the parsed DependentThoroughfare element from the input.


Line 965: Line 1,114:




<h3 style="background-color:rgb(240,240,240);">DependentThoroughfarePreDirection</h3>
<h3 class="h3grey">DependentThoroughfarePreDirection</h3>
:This is a string value that is the parsed DependentThoroughfarePreDirection element from the input.
:This is a string value that is the parsed DependentThoroughfarePreDirection element from the input.


Line 975: Line 1,124:




<h3 style="background-color:rgb(240,240,240);">DependentThoroughfareLeadingType</h3>
<h3 class="h3grey">DependentThoroughfareLeadingType</h3>
:This is a string value that is the parsed DependentThoroughfareLeadingType element from the input.
:This is a string value that is the parsed DependentThoroughfareLeadingType element from the input.


Line 985: Line 1,134:




<h3 style="background-color:rgb(240,240,240);">DependentThoroughfareName</h3>
<h3 class="h3grey">DependentThoroughfareName</h3>
:This is a string value that is the parsed DependentThoroughfareName element from the input.
:This is a string value that is the parsed DependentThoroughfareName element from the input.


Line 995: Line 1,144:




<h3 style="background-color:rgb(240,240,240);">DependentThoroughfareTrailingType</h3>
<h3 class="h3grey">DependentThoroughfareTrailingType</h3>
:This is a string value that is the parsed DependentThoroughfareTrailingType element from the input.
:This is a string value that is the parsed DependentThoroughfareTrailingType element from the input.


Line 1,005: Line 1,154:




<h3 style="background-color:rgb(240,240,240);">DependentThoroughfarePostDirection</h3>
<h3 class="h3grey">DependentThoroughfarePostDirection</h3>
:This is a string value that is the parsed DependentThoroughfarePostDirection element from the input.
:This is a string value that is the parsed DependentThoroughfarePostDirection element from the input.


Line 1,015: Line 1,164:




<h3 style="background-color:rgb(240,240,240);">Building</h3>
<h3 class="h3grey">Building</h3>
:This is a string value that is the parsed Building element from the input.
:This is a string value that is the parsed Building element from the input.


Line 1,025: Line 1,174:




<h3 style="background-color:rgb(240,240,240);">PremisesType</h3>
<h3 class="h3grey">PremisesType</h3>
:This is a string value that is the parsed PremisesType element from the input.
:This is a string value that is the parsed PremisesType element from the input.


Line 1,035: Line 1,184:




<h3 style="background-color:rgb(240,240,240);">PremisesNumber</h3>
<h3 class="h3grey">PremisesNumber</h3>
:This is a string value that is the parsed PremisesNumber element from the input.
:This is a string value that is the parsed PremisesNumber element from the input.


Line 1,045: Line 1,194:




<h3 style="background-color:rgb(240,240,240);">SubPremisesType</h3>
<h3 class="h3grey">SubPremisesType</h3>
:This is a string value that is the parsed SubPremisesType element from the input.
:This is a string value that is the parsed SubPremisesType element from the input.


Line 1,055: Line 1,204:




<h3 style="background-color:rgb(240,240,240);">SubPremisesNumber</h3>
<h3 class="h3grey">SubPremisesNumber</h3>
:This is a string value that is the parsed SubPremisesNumber element from the input.
:This is a string value that is the parsed SubPremisesNumber element from the input.


Line 1,065: Line 1,214:




<h3 style="background-color:rgb(240,240,240);">PostBox</h3>
<h3 class="h3grey">PostBox</h3>
:This is a string value that is the parsed PostBox element from the input.
:This is a string value that is the parsed PostBox element from the input.


Line 1,075: Line 1,224:




<h3 style="background-color:rgb(240,240,240);">Latitude</h3>
<h3 class="h3grey">Latitude</h3>
:This is a string value that is the parsed Latitude element from the input.
:This is a string value that is the parsed Latitude element from the input.


Line 1,085: Line 1,234:




<h3 style="background-color:rgb(240,240,240);">Longitude</h3>
<h3 class="h3grey">Longitude</h3>
:This is a string value that is the parsed Longitude element from the input.
:This is a string value that is the parsed Longitude element from the input.


Line 1,096: Line 1,245:


==Email==
==Email==
<h3 style="background-color:rgb(240,240,240);">Results</h3>
<h3 class="h3grey">Deliverability Confidence Score</h3>
:Returns the probability [0-100]% of an email sent to this mailbox will be successfully delivered.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DeliverabilityConfidenceScore":"'''''string'''''"</code>
|}
 
 
<h3 class="h3grey">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.


:For a complete list of codes, see [[Result Code Details#Personator Identity Verification|Personator Identity Verification Result Codes]].
:For a complete list of codes, see [[Result Code Details#Personator Identity|Personator Identity Result Codes]].


:{| class="alternate01"
:{| class="alternate01"
Line 1,108: Line 1,267:




<h3 style="background-color:rgb(240,240,240);">Email Address</h3>
<h3 class="h3grey">Email Address</h3>
:This is a string value listing the email address, including any corrections or changes made by Global Email.
:This is a string value listing the email address, including any corrections or changes made by Global Email.


Line 1,118: Line 1,277:




<h3 style="background-color:rgb(240,240,240);">Mailbox Name</h3>
<h3 class="h3grey">Mailbox Name</h3>
:This is a string value listing the mailbox or user name portion of the email address (All characters preceding the "@" character).
:This is a string value listing the mailbox or user name portion of the email address (All characters preceding the "@" character).


Line 1,130: Line 1,289:




<h3 style="background-color:rgb(240,240,240);">Domain Name</h3>
<h3 class="h3grey">Domain Name</h3>
:This is a string value listing the domain name portion of the email address (All characters between the "@" and "." characters).
:This is a string value listing the domain name portion of the email address (All characters between the "@" and "." characters).


Line 1,142: Line 1,301:




<h3 style="background-color:rgb(240,240,240);">Top Level Domain</h3>
<h3 class="h3grey">Top Level Domain</h3>
:This is a string value listing the description associated with the top-level domain name of the email address.
:This is a string value listing the description associated with the top-level domain name of the email address.


Line 1,152: Line 1,311:




<h3 style="background-color:rgb(240,240,240);">Top Level Domain Name</h3>
<h3 class="h3grey">Top Level Domain Name</h3>
:This is a string value listing the top level domain name portion of the email address (All characters after the ".").
:This is a string value listing the top level domain name portion of the email address (All characters after the ".").


Line 1,164: Line 1,323:




<h3 style="background-color:rgb(240,240,240);">Date Checked</h3>
<h3 class="h3grey">Date Checked</h3>
:This is a string value listing the date the email was last checked. DateChecked field returns a UTC, Unix Time (Epoch Time).
:This is a string value listing the date the email was last checked. DateChecked field returns a UTC, Unix Time (Epoch Time).


Line 1,171: Line 1,330:
|-
|-
|JSON||<code>"DateChecked":"'''''string'''''"</code>
|JSON||<code>"DateChecked":"'''''string'''''"</code>
|}
<h3 class="h3grey">Email Age Estimated</h3>
:The estimated minimum age of the email in days based on historical data. The value is zero when we lack historical data on a given email.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"EmailAgeEstimated":"'''''string'''''"</code>
|}
<h3 class="h3grey">Domain Age Estimated</h3>
:The estimated age of the domain in days.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DomainAgeEstimated":"'''''string'''''"</code>
|}
<h3 class="h3grey">Domain Expiration Date</h3>
:The date the domain expires/expired in the YYYY-MM-DDTHH:MM:SS format.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DomainExpirationDate":"'''''string'''''"</code>
|}
<h3 class="h3grey">Domain Created Date</h3>
:The date the domain was created in the YYYY-MM-DDTHH:MM:SS format.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DomainCreatedDate":"'''''string'''''"</code>
|}
<h3 class="h3grey">Domain Updated Date</h3>
:The date the domain was last updated in the YYYY-MM-DDTHH:MM:SS format.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DomainUpdatedDate":"'''''string'''''"</code>
|}
<h3 class="h3grey">Domain Email</h3>
:The email associated with the domain.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DomainEmail":"'''''string'''''"</code>
|}
<h3 class="h3grey">Domain Organization</h3>
:The organization associated with the domain.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DomainOrganization":"'''''string'''''"</code>
|}
<h3 class="h3grey">Domain Address 1</h3>
:The street address associated with the domain.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DomainAddress1":"'''''string'''''"</code>
|}
<h3 class="h3grey">Domain Locality</h3>
:The locality associated with the domain.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DomainLocality":"'''''string'''''"</code>
|}
<h3 class="h3grey">Domain Administrative Area</h3>
:The administrative area associated with the domain.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DomainAdministrativeArea":"'''''string'''''"</code>
|}
<h3 class="h3grey">Domain Postal Code</h3>
:The postal code associated with the domain.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DomainPostalCode":"'''''string'''''"</code>
|}
<h3 class="h3grey">Domain Country</h3>
:The country associated with the domain.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DomainCountry":"'''''string'''''"</code>
|}
<h3 class="h3grey">Domain Availability</h3>
:Check to see if domain is available for purchase.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DomainAvailability":"'''''string'''''"</code>
|}
<h3 class="h3grey">Domain Country Code</h3>
:The country code associated with the domain.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DomainCountryCode":"'''''string'''''"</code>
|}
<h3 class="h3grey">Domain Private Proxy</h3>
:Check if domain is behind a private proxy.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DomainPrivateProxy":"'''''string'''''"</code>
|}
<h3 class="h3grey">Privacy Flag</h3>
:The top level domain may be sensitive to privacy laws. Returns Y for yes and N for no.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"PrivacyFlag":"'''''string'''''"</code>
|}
<h3 class="h3grey">MX Server</h3>
:Returns which Mail Exchange (MX) Server was used to validate the email.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"MXServer":"'''''string'''''"</code>
|}
<h3 class="h3grey">Breach Count</h3>
:Returns blank. This is a placeholder for an upcoming feature.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"BreachCount":"'''''string'''''"</code>
|}
|}




==Phone==
==Phone==
<h3 style="background-color:rgb(240,240,240);">Results</h3>
<h3 class="h3grey">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.


:For a complete list of codes, see [[Result Code Details#Personator Identity Verification|Personator Identity Verification Result Codes]].
:For a complete list of codes, see [[Result Code Details#Personator Identity|Personator Identity Result Codes]].


:{| class="alternate01"
:{| class="alternate01"
Line 1,187: Line 1,526:




<h3 style="background-color:rgb(240,240,240);">Phone Number</h3>
<h3 class="h3grey">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 1,234: Line 1,573:




<h3 style="background-color:rgb(240,240,240);">Administrative Area</h3>
<h3 class="h3grey">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 1,246: Line 1,585:




<h3 style="background-color:rgb(240,240,240);">Country Abbreviation</h3>
<h3 class="h3grey">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 1,256: Line 1,595:




<h3 style="background-color:rgb(240,240,240);">Country Name</h3>
<h3 class="h3grey">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 1,268: Line 1,607:




<h3 style="background-color:rgb(240,240,240);">Carrier</h3>
<h3 class="h3grey">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 1,278: Line 1,617:




<h3 style="background-color:rgb(240,240,240);">Caller ID</h3>
<h3 class="h3grey">Caller ID</h3>
:''US and Canada Only.''
 
:This is the result from our CallerID service, which it appends the name to the targeted phone number.
:This is the result from our CallerID service, which it appends the name to the targeted phone number.


Line 1,288: Line 1,629:




<h3 style="background-color:rgb(240,240,240);">Daylight Savings Time</h3>
<h3 class="h3grey">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 1,300: Line 1,641:




<h3 style="background-color:rgb(240,240,240);">International Phone Number</h3>
<h3 class="h3grey">International Phone Number</h3>
:This is the number you would dial, given your output fields, in order to successfully send a call.
:This is the number you would dial, given your output fields, in order to successfully send a call.


Line 1,312: Line 1,653:




<h3 style="background-color:rgb(240,240,240);">Language</h3>
<h3 class="h3grey">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.


Line 1,326: Line 1,667:




<h3 style="background-color:rgb(240,240,240);">Latitude</h3>
<h3 class="h3grey">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 1,340: Line 1,681:




<h3 style="background-color:rgb(240,240,240);">Locality</h3>
<h3 class="h3grey">Locality</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 locality (city) associated with the phone number passed to the Lookup function.


Line 1,352: Line 1,693:




<h3 style="background-color:rgb(240,240,240);">Longitude</h3>
<h3 class="h3grey">Longitude</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 longitude of the geographically identifiable service area of the exchange.


Line 1,366: Line 1,707:




<h3 style="background-color:rgb(240,240,240);">International Prefix</h3>
<h3 class="h3grey">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 1,378: Line 1,719:




<h3 style="background-color:rgb(240,240,240);">Country Dialing Code</h3>
<h3 class="h3grey">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 1,390: Line 1,731:




<h3 style="background-color:rgb(240,240,240);">Nation Prefix</h3>
<h3 class="h3grey">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 1,404: Line 1,745:




<h3 style="background-color:rgb(240,240,240);">National Destination Code</h3>
<h3 class="h3grey">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 1,416: Line 1,757:




<h3 style="background-color:rgb(240,240,240);">Subscriber Number</h3>
<h3 class="h3grey">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 1,430: Line 1,771:




<h3 style="background-color:rgb(240,240,240);">Universal Time Code</h3>
<h3 class="h3grey">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 1,444: Line 1,785:




<h3 style="background-color:rgb(240,240,240);">Postal Code</h3>
<h3 class="h3grey">Postal Code</h3>
:The zip code that corresponds to a locality inside the United States.
:The zip code that corresponds to a locality inside the United States.


Line 1,456: Line 1,797:




<h3 style="background-color:rgb(240,240,240);">Suggestions</h3>
<h3 class="h3grey">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 1,466: Line 1,807:




[[Category:Personator Identity Verification]]
[[Category:Personator Identity]]
[[Category:Reference]]
[[Category:Reference]]

Latest revision as of 23:38, 26 February 2024

← Personator Identity

Personator Identity Navigation
Introduction
Licensing
Input/Output
Request Fields
Response Fields
Examples
REST JSON
POST JSON
Result Codes
Result Code Use
Personator Identity Result Codes
Sample Code



A response is the result of a request. This consists of returned result codes.

The web service returns back a response in a JSON format.


Field Names

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

Field Name Level JSON
Transaction ID Response (Base) TransactionID
Transmission Reference TransmissionReference
Results Results
Version Version
Results Identity Results
Confidence Confidence
Datasources Datasources
Watchlists Watchlists
Watchlist persons WatchlistPersons
National ID NationalID
Date of birth DateOfBirth
Account Number AccountNumber
Business Information BusinessInformation
Results Name Results
Company Company
Name prefix NamePrefix
NameFirst NameFirst
NameMiddle NameMiddle
NameLast NameLast
NameSuffix NameSuffix
Gender Gender
NamePrefix2 NamePrefix2
NameFirst2 NameFirst2
NameMiddle2 NameMiddle2
NameLast2 NameLast2
NameSuffix2 NameSuffix2
Gender2 Gender2
Results Address Results
FormattedAddress FormattedAddress
Organization Organization
AddressLine1 AddressLine1
AddressLine2 AddressLine2
AddressLine3 AddressLine3
AddressLine4 AddressLine4
AddressLine5 AddressLine5
AddressLine6 AddressLine6
AddressLine7 AddressLine7
AddressLine8 AddressLine8
SubPremises SubPremises
DoubleDependentLocality DoubleDependentLocality
DependentLocality DependentLocality
Locality Locality
SubAdministrativeArea SubAdministrativeArea
AdministrativeArea AdministrativeArea
PostalCode PostalCode
AddressType AddressType
AddressKey AddressKey
SubNationalArea SubNationalArea
CountryName CountryName
CountryCode CountryCode
CountryISO3 CountryISO3
CountryNumber CountryNumber
CountrySubdivisionCode CountrySubdivisionCode
Thoroughfare Thoroughfare
ThoroughfarePreDirection ThoroughfarePreDirection
ThoroughfareLeadingType ThoroughfareLeadingType
ThoroughfareName ThoroughfareName
ThoroughfareTrailingType ThoroughfareTrailingType
ThoroughfarePostDirection ThoroughfarePostDirection
DependentThoroughfare DependentThoroughfare
DependentThoroughfarePreDirection DependentThoroughfarePreDirection
DependentThoroughfareLeadingType DependentThoroughfareLeadingType
DependentThoroughfareName DependentThoroughfareName
DependentThoroughfareTrailingType DependentThoroughfareTrailingType
DependentThoroughfarePostDirection DependentThoroughfarePostDirection
Building Building
PremisesType PremisesType
PremisesNumber PremisesNumber
SubPremisesType SubPremisesType
SubPremisesNumber SubPremisesNumber
PostBox PostBox
Latitude Latitude
Longitude Longitude
Deliverability Confidence Score Email DeliverabilityConfidenceScore
Results Results
Email address EmailAddress
Mailbox name MailboxName
Domain name DomainName
Top level domain TopLevelDomain
Top level domain name TopLevelDomainName
Date checked DateChecked
Email Age Estimated EmailAgeEstimated
Domain Age Estimated DomainAgeEstimated
Domain Expiration Date DomainExpirationDate
Domain Created Date DomainCreatedDate
Domain Updated Date DomainUpdatedDate
Domain Email DomainEmail
Domain Organization DomainOrganization
Domain Address 1 DomainAddress1
Domain Locality DomainLocality
Domain Administrative Area DomainAdministrativeArea
Domain Postal Code DomainPostalCode
Domain Country DomainCountry
Domain Availability DomainAvailability
Domain Country Code DomainCountryCode
Domain Private Proxy DomainPrivateProxy
Privacy Flag PrivacyFlag
MX Server MXServer
Breach Count BreachCount
Results Phone 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


Response Elements

The following fields are in the response.


Response (Base Level)

TransactionID

This is a string value that serves as a unique identifier for this record. A unique transaction ID is generated for every record handled by Personator Identity.
Protocol Syntax
JSON "TransactionID":"string"


TransmissionReference

This is a string value that serves as a unique identifier for this request. It is returned as sent in the request, allowing you to match the response to the request.
Protocol Syntax
JSON "TransmissionReference":"string"


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 Personator Identity Result Codes.

Protocol Syntax
JSON "Results":"string"


Version

This is a string value that is the current revision number of Personator Identity web service.
Protocol Syntax
JSON "Version":"string"


Identity

Results

This is a string value that lists the ID verification codes (KV*).
For a complete list of ID verification codes, see Personator Identity Result Codes.
Protocol Syntax
JSON "Results":"string"


Confidence

This is a string value containing a value indicating how reliable the record is after performing ID verification.
The 3 possible values returned:
Value Meaning
High Passing or high quality score
Medium Possible pass with multiple matching elements
Low None or minimal match rate


Protocol Syntax
JSON "Confidence":"string"


Datasources

Contains an array of data sources where a match is found against the input. This field is only available when the Verify action is specified. Otherwise a null value is returned.
Field Meaning
DatasourceName A string value indicating the name/type of data source.
Results A string value containing the KV* result codes, indicating how the input matched against this particular data source.
Messages An array object, listing the meaning of each KV* result code for this data source.
Messages -> ResultCode The particular KV* result code.
Messages -> Descripton A string value containing the description/meaning of the KV* result code.


Protocol Syntax

JSON 
"Datasources":
  [
  "DatasourceName":"",
  "Results":"",
  "Messages":
    [{
      "ResultCode":"",
      "Description":""
    }]
  ]


Watchlists

An object with three fields.
For a list of used watchlists, see Personator Identity Watchlists.
Field Meaning
Hit Returns a string containing either Yes or No.
Sources Returns an array of the names of watchlists the individual was found on.
Name A string value containing the name of the Watchlist source that was matched.
Code A two letter string representing the code attributed to the watchlist source. Premium Watchlist matches will always return PR.
Type A string value containing the type or category of Watchlist that was matched against.
Date A string value containing the date (YYYY-MM-DD) of when the Watchlist source was created. An empty string will be returned if the source does not have this information.
Articles Returns the title, link and date of the article.


Protocol Syntax Example

JSON

"Watchlists": { 

 "Hit":"string",
 "Sources":
   [{
     "Name":"string",
     "Code":"string",
     "Type":"string",
     "Date":"string"
   }]
 },
 "Articles":
   [{
     "Title":"string",
     "Link":"string",
     "Date":"string"
   }]
 }

"Watchlists": { 

 "Hit":"Yes",
 "Sources":
   [{
     "Name":"Specially Designated Nationals OFAC",
     "Code":"",
     "Type":"sanction",
     "Date":""
   },
   {
     "Name":"United Kingdom HM Treasury",
     "Code": "PR",
     "Type": "sanction",
     "Date": "2005-12-07"
   }],
 "Articles":
   [{
     "Title":"SampleTitleName",
     "Link":"http://samplereportlink.com",
     "Date":"2017-09-30T00:00:00Z"
   }],
 }


WatchlistsPersons

Blank (Currently reserved for future) – A string value listing the potential names that were found matched on a watchlist.
Protocol Syntax
JSON "WatchlistPersons":"string"


NationalID

A string value containing the input national ID returned as is.
Protocol Syntax
JSON "NationalID":"string"


DateOfBirth

A string value containing the input date of birth returned as is.
Protocol Syntax
JSON "DateOfBirth":"string"


AccountNumber

An object that returns one field for account number status.
Field Meaning
Validated Returns a string containing either Y or N.
Protocol Syntax Example
JSON "AccountNumber": {

"Validated":"string"
}

"AccountNumber": {

"Validated":"Y"
}


BusinessInformation

An object that returns the following Business Information:
Field Meaning
Name Name of the business that matched
ID Business ID. Uses the official business ID specific to the country:
  • US: EIN
  • SG: Unique Entity Number
  • CA: Corporations Number or Business Number
  • DE: German Trade Register or Handelsregister (HRB)
Status The current status of the business. e.g. "Active".
Type Business Type, e.g. "Corporation", "Limited Liability Company".
Date Registration Date of the business, in the YYYY-MM-DD format.


Protocol Syntax Example
JSON "BusinessInformation": {

"Name":"string",
"ID":"string",
"Status":"string",
"Type":"string",
"RegistrationDate":"string"
}

"BusinessInformation": {

"Name":"Melissa Data",
"ID":"0123456",
"Status":" ",
"Type":"Corporation",
"RegistrationDate":"1985-01-01"
}


Name

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 Personator Identity Result Codes.
Protocol Syntax
JSON "Results":"string"


Company

This is a string value of the standardized company name.
Protocol Syntax
JSON "Company":"string"


NamePrefix

This is a string value of the first prefix (such as “Mr.” or “Dr.”) from an inputted full name.
If the FullName input property contained a single name, the prefix, if any, will be returned here. If two names were passed, the first of the two prefixes will be returned by this property.
Protocol Syntax
JSON "NamePrefix":"string"


NameFirst

This is a string value of the first name from an inputted full name.
If the FullName input property contained a single name, the first name, if any, will be returned here. If two names were passed, the first of the two first names will be returned by this property.
Protocol Syntax
JSON "NameFirst":"string"


NameMiddle

This is a string value of the middle name from an inputted full name.
If the FullName input property contained a single name, the middle name, if any, will be returned here. If two names were passed, the first of the two middle names will be returned by this property.
Protocol Syntax
JSON "NameMiddle":"string"


NameLast

This is a string value of the last name from an inputted full name.
If the FullName input property contained a single name, the last name, if any, will be returned here. If two names were passed, the first of the two last names will be returned by this property.
Protocol Syntax
JSON "NameLast":"string"


NameSuffix

This is a string value of the first suffix (such as “Jr.” or “III”) from an inputted full name.
If the FullName input property contained a single name, the suffix, if any, will be returned here. If two names were passed, the first of the two suffixes will be returned by this property.
Protocol Syntax
JSON "NameSuffix":"string"


Gender

This is a one-character string value indicating the gender of the first name from the input.
Code Description
M Male
F Female
U Unknown first name or no first name present
N A neutral first name


Protocol Syntax
JSON "Gender":"string"


NamePrefix2

This is a string value of the second prefix (such as “Mr.” or “Dr.”) from an inputted full name.
If the FullName input property contained multiple names, the second prefix will be returned here.
Protocol Syntax
JSON "NamePrefix2":"string"


NameFirst2

This is a string value of the second first name from an inputted full name.
If the FullName input property contained multiple names, the second first name will be returned here.
Protocol Syntax
JSON "NameFirst2":"string"


NameMiddle2

This is a string value of the second middle name from an inputted full name.
If the FullName input property contained multiple names, the second middle name, if any, will be returned here.
Protocol Syntax
JSON "NameMiddle2":"string"


NameLast2

This is a string value of the second last name from an inputted full name.
If the FullName input property contained multiple names, the second last name, if any, will be returned here.
Protocol Syntax
JSON "NameLast2":"string"


NameSuffix2

This is a string value of the second suffix (such as “Jr.” or “III”) from an inputted full name.
If the FullName input property contained multiple names, the second suffix, if any, will be returned here.
Protocol Syntax
JSON "NameSuffix2":"string"


Gender2

This is a one-character string value indicating the gender of the inputted full name.
If the FullName input property contained multiple names, the gender of the second name will be returned here.
Code Description
M Male
F Female
U Unknown first name or no first name present
N A neutral first name


Protocol Syntax
JSON "Gender2":"string"


Address

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 Personator Identity Result Codes.
Protocol Syntax
JSON "Results":"string"


FormattedAddress

This is a string value that is the address in the correct format for mailing from the country specified in the CountryOfOrigin element. This includes the Organization as the first line, one or more lines in the origin country’s format, and the destination country (if required). Separate lines will be delimited by what is specified in the option. See LineSeparator for more information.
Protocol Syntax
JSON "FormattedAddress":"string"


Organization

This is a string value that matches the Organization request element. It is not modified or populated by the Cloud Service.
Protocol Syntax
JSON "Organization":"string"


AddressLine1

These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
Protocol Syntax
JSON "AddressLine1":"string"


AddressLine2

These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
Protocol Syntax
JSON "AddressLine2":"string"


AddressLine3

These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
Protocol Syntax
JSON "AddressLine3":"string"


AddressLine4

These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
Protocol Syntax
JSON "AddressLine4":"string"


AddressLine5

These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
Protocol Syntax
JSON "AddressLine5":"string"


AddressLine6

These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
Protocol Syntax
JSON "AddressLine6":"string"


AddressLine7

These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
Protocol Syntax
JSON "AddressLine7":"string"


AddressLine8

These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
Protocol Syntax
JSON "AddressLine8":"string"


SubPremises

This is a string value that is the parsed SubPremises from the AddressLine elements.
US Term: Suite
Protocol Syntax
JSON "SubPremises":"string"


DoubleDependentLocality

This is a string value that is the standardized contents of the DoubleDependentLocality element.
Protocol Syntax
JSON "DoubleDependentLocality":"string"


DependentLocality

This is a string value that is the standardized contents of the DependentLocality element.
Protocol Syntax
JSON "DependentLocality":"string"


Locality

This is a string value that is the standardized contents of the Locality element.
Protocol Syntax
JSON "Locality":"string"


SubAdministrativeArea

This is a string value that is the standardized contents of the SubAdministrativeArea element.
Protocol Syntax
JSON "SubAdministrativeArea":"string"


AdministrativeArea

This is a string value that is the standardized contents of the AdministrativeArea element.
Protocol Syntax
JSON "AdministrativeArea":"string"


PostalCode

This is a string value that is the standardized contents of the PostalCode element.
Protocol Syntax
JSON "PostalCode":"string"


Appended Address Record Elements

AddressType

This is an appended string value that returns a one-character code for the type of address coded. This element works only for US and Canadian addresses.
Protocol Syntax
JSON "AddressType":"string"


AddressKey

This is a string value that is a unique key for the address. Only for US and Canadian addresses.
The AddressKey can be used by other Melissa Data services, such as Geocoder or RBDI.
Protocol Syntax
JSON "AddressKey":"string"


SubNationalArea

This is a string value that is the standardized contents of the SubNationalArea element.
Protocol Syntax
JSON "SubNationalArea":"string"


CountryName

This is a string value that is the standardized contents of the CountryName element.
Protocol Syntax
JSON "CountryName":"string"


CountryCode

This is a string value that is the parsed CountryCode element from the input.
For example:
Country Code
United States US
Canada CA
Philippines PH


Protocol Syntax
JSON "CountryCode":"string"


CountryISO3

This is a string value that is the parsed CountryISO3 element from the input.
For example:
Country Code
United States USA
Canada CAN
Philippines PHL


Protocol Syntax
JSON "CountryISO3":"string"


CountryNumber

This is a string value that is the parsed CountryNumber element from the input.
For example:
Country Code
United States 840
Canada 124
Philippines 608


Protocol Syntax
JSON "CountryNumber":"string"


CountrySubdivisionCode

This is the ISO3166-2 code for country subdivisions, usually the administrative area for a country. The format is the 2 letter country code followed by a dash followed by 2 or 3 characters or two numbers. Examples are: US-CA, CN-16, or AU-VIC.
Currently, this field is only populated for some countries. These countries are: AU, BR, CA, CN, CR, DM, GT, HN, NI, MX, SV, US.
Protocol Syntax
JSON "CountrySubdivisionCode":"string"


Thoroughfare

This is a string value that is the parsed Thoroughfare element from the input.
Protocol Syntax
JSON "Thoroughfare":"string"


ThoroughfarePreDirection

This is a string value that is the parsed ThoroughfarePreDirection element from the input.
Protocol Syntax
JSON "ThoroughfarePreDirection":"string"


ThoroughfareLeadingType

This is a string value that is the parsed ThoroughfareLeadingType element from the input.
Protocol Syntax
JSON "ThoroughfareLeadingType":"string"


ThoroughfareName

This is a string value that is the parsed ThoroughfareName element from the input.
Protocol Syntax
JSON "ThoroughfareName":"string"


ThoroughfareTrailingType

This is a string value that is the parsed ThoroughfareTrailingType element from the input.
Protocol Syntax
JSON "ThoroughfareTrailingType":"string"


ThoroughfarePostDirection

This is a string value that is the parsed ThoroughfarePostDirection element from the input.
Protocol Syntax
JSON "ThoroughfarePostDirection":"string"


DependentThoroughfare

This is a string value that is the parsed DependentThoroughfare element from the input.
Protocol Syntax
JSON "DependentThoroughfare":"string"


DependentThoroughfarePreDirection

This is a string value that is the parsed DependentThoroughfarePreDirection element from the input.
Protocol Syntax
JSON "DependentThoroughfarePreDirection":"string"


DependentThoroughfareLeadingType

This is a string value that is the parsed DependentThoroughfareLeadingType element from the input.
Protocol Syntax
JSON "DependentThoroughfareLeadingType":"string"


DependentThoroughfareName

This is a string value that is the parsed DependentThoroughfareName element from the input.
Protocol Syntax
JSON "DependentThoroughfareName":"string"


DependentThoroughfareTrailingType

This is a string value that is the parsed DependentThoroughfareTrailingType element from the input.
Protocol Syntax
JSON "DependentThoroughfareTrailingType":"string"


DependentThoroughfarePostDirection

This is a string value that is the parsed DependentThoroughfarePostDirection element from the input.
Protocol Syntax
JSON "DependentThoroughfarePostDirection":"string"


Building

This is a string value that is the parsed Building element from the input.
Protocol Syntax
JSON "Building":"string"


PremisesType

This is a string value that is the parsed PremisesType element from the input.
Protocol Syntax
JSON "PremisesType":"string"


PremisesNumber

This is a string value that is the parsed PremisesNumber element from the input.
Protocol Syntax
JSON "PremisesNumber":"string"


SubPremisesType

This is a string value that is the parsed SubPremisesType element from the input.
Protocol Syntax
JSON "SubPremisesType":"string"


SubPremisesNumber

This is a string value that is the parsed SubPremisesNumber element from the input.
Protocol Syntax
JSON "SubPremisesNumber":"string"


PostBox

This is a string value that is the parsed PostBox element from the input.
Protocol Syntax
JSON "PostBox":"string"


Latitude

This is a string value that is the parsed Latitude element from the input.
Protocol Syntax
JSON "Latitude":"string"


Longitude

This is a string value that is the parsed Longitude element from the input.
Protocol Syntax
JSON "Longitude":"string"


Email

Deliverability Confidence Score

Returns the probability [0-100]% of an email sent to this mailbox will be successfully delivered.
Protocol Syntax
JSON "DeliverabilityConfidenceScore":"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 Personator Identity Result Codes.
Protocol Syntax
JSON "Results":"string"


Email Address

This is a string value listing the email address, including any corrections or changes made by Global Email.
Protocol Syntax
JSON "EmailAddress":"string"


Mailbox Name

This is a string value listing the mailbox or user name portion of the email address (All characters preceding the "@" character).
With an example email of "sample@melissadata.com" the mailbox name would be "sample".
Protocol Syntax
JSON "MailboxName":"string"


Domain Name

This is a string value listing the domain name portion of the email address (All characters between the "@" and "." characters).
With an example email of "sample@melissadata.com" the domain name would be "melissadata".
Protocol Syntax
JSON "DomainName":"string"


Top Level Domain

This is a string value listing the description associated with the top-level domain name of the email address.
Protocol Syntax
JSON "Top Level Domain":"string"


Top Level Domain Name

This is a string value listing the top level domain name portion of the email address (All characters after the ".").
With an example email of "sample@melissadata.com" the top level domain name would be "com".
Protocol Syntax
JSON "TopLevelDomainName":"string"


Date Checked

This is a string value listing the date the email was last checked. DateChecked field returns a UTC, Unix Time (Epoch Time).
Protocol Syntax
JSON "DateChecked":"string"


Email Age Estimated

The estimated minimum age of the email in days based on historical data. The value is zero when we lack historical data on a given email.
Protocol Syntax
JSON "EmailAgeEstimated":"string"


Domain Age Estimated

The estimated age of the domain in days.
Protocol Syntax
JSON "DomainAgeEstimated":"string"


Domain Expiration Date

The date the domain expires/expired in the YYYY-MM-DDTHH:MM:SS format.
Protocol Syntax
JSON "DomainExpirationDate":"string"


Domain Created Date

The date the domain was created in the YYYY-MM-DDTHH:MM:SS format.
Protocol Syntax
JSON "DomainCreatedDate":"string"


Domain Updated Date

The date the domain was last updated in the YYYY-MM-DDTHH:MM:SS format.
Protocol Syntax
JSON "DomainUpdatedDate":"string"


Domain Email

The email associated with the domain.
Protocol Syntax
JSON "DomainEmail":"string"


Domain Organization

The organization associated with the domain.
Protocol Syntax
JSON "DomainOrganization":"string"


Domain Address 1

The street address associated with the domain.
Protocol Syntax
JSON "DomainAddress1":"string"


Domain Locality

The locality associated with the domain.
Protocol Syntax
JSON "DomainLocality":"string"


Domain Administrative Area

The administrative area associated with the domain.
Protocol Syntax
JSON "DomainAdministrativeArea":"string"


Domain Postal Code

The postal code associated with the domain.
Protocol Syntax
JSON "DomainPostalCode":"string"


Domain Country

The country associated with the domain.
Protocol Syntax
JSON "DomainCountry":"string"


Domain Availability

Check to see if domain is available for purchase.
Protocol Syntax
JSON "DomainAvailability":"string"


Domain Country Code

The country code associated with the domain.
Protocol Syntax
JSON "DomainCountryCode":"string"


Domain Private Proxy

Check if domain is behind a private proxy.
Protocol Syntax
JSON "DomainPrivateProxy":"string"


Privacy Flag

The top level domain may be sensitive to privacy laws. Returns Y for yes and N for no.
Protocol Syntax
JSON "PrivacyFlag":"string"


MX Server

Returns which Mail Exchange (MX) Server was used to validate the email.
Protocol Syntax
JSON "MXServer":"string"


Breach Count

Returns blank. This is a placeholder for an upcoming feature.
Protocol Syntax
JSON "BreachCount":"string"


Phone

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 Personator Identity 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

US and Canada Only.
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"
Retrieved from "http://wiki.melissadata.com/index.php?title=Personator_Identity:Response&oldid=20006"