Personator Search:Response: Difference between revisions

From Melissa Data Wiki
Jump to navigation Jump to search
Newer edit →
Created page with "{{PersonatorSearchNav |InputOutputCollapse= }} {{CustomTOC}} A response is the result of a request. This consists of returned result codes. The web service returns back a ..."
 
No edit summary
Line 17: Line 17:
!Field Name !! Level !! JSON
!Field Name !! Level !! JSON
|-
|-
|Transmission Reference ||rowspan="6" valign="center"| Response (Base) || TransmissionReference
|Results ||rowspan="6" valign="center"| Response (Base) || Results
|-
|-
|Transmission Results || TransmissionResults
|Transmission Results || TransmissionResults
|-
|-
|Total Records || TotalRecords
|Transmission Reference || TransmissionReference
|-
|-
|Total Pages || TotalPages
|Total Pages || TotalPages
|-
|-
|Results || Results
|Total Records || TotalRecords
|-
|-
|Version || Version
|Version || Version
|-
|-
|Records ||rowspan="6" valign="center"| Record || Results
|Record ID ||rowspan="11" valign="center"| Record || RecordID
|-
|-
|Current Address || CurrentAddress
|Results || Results
|-
|-
|Full Name || FullName
|Full Name || FullName
Line 38: Line 38:
|-
|-
|Last Name || LastName
|Last Name || LastName
|-
|Middle Name || MiddleName
|-
|-
|Date of Birth || DateOfBirth
|Date of Birth || DateOfBirth
Line 45: Line 43:
|Date of Death || DateOfDeath
|Date of Death || DateOfDeath
|-
|-
|Record ID || RecordID
|Current Address || CurrentAddress
|-
|Previous Address Records || PreviousAddressRecords
|-
|Phone Records || PhoneRecords
|-
|Email Records || EmailRecords
|-
|-
|Results || Results
|Address Line 1 ||rowspan="9" valign="center"| CurrentAddress || AddressLine1
|-
|Suite || Suite
|-
|City || City
|-
|State || State
|-
|Postal Code || PostalCode
|-
|Plus4 || Plus4
|-
|Melissa Address Key || MelissaAddressKey
|-
|Melissa Address Key Base || MelissaAddressKeyBase
|-
|Move Date || MoveDate
|-
|-
|Address Line 1 ||rowspan="" valign="center"| CurrentAddress || AddressLine1
|Address Line 1 ||rowspan="9" valign="center"| PreviousAddressRecords || AddressLine1
|-
|-
|Suite || Suite
|Suite || Suite
Line 67: Line 87:
|Move Date || MoveDate
|Move Date || MoveDate
|-
|-
 
|Phone || PhoneRecords || Phone
|-
|Email || EmailRecords || Email
|}
|}


Line 76: Line 98:


==Response (Base Level)==
==Response (Base Level)==
<h3 style="background-color:rgb(240,240,240);">TransmissionReference</h3>
<h3 style="background-color:rgb(240,240,240);">Results</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 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 Search|Personator Search Result Codes]].


:{| class="alternate01"
:{| class="alternate01"
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||<code>"TransmissionReference":"'''''string'''''"</code>
|JSON||<code>"Results":"'''''string'''''"</code>
|}
|}




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


:{| class="alternate01"
:{| class="alternate01"
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||<code>"Results":"'''''string'''''"</code>
|JSON||<code>"TransmissionReference":"'''''string'''''"</code>
|}
|}




Line 107: Line 132:




==Identity==
==Record==
<h3 style="background-color:rgb(240,240,240);">Results</h3>
<h3 style="background-color:rgb(240,240,240);">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*).
Line 129: Line 154:
|}
|}


==Name==
<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.
:For a complete list of codes, see [[Result Code Details#Personator Search|Personator Search Result Codes]].
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"Results":"'''''string'''''"</code>
|}
<h3 style="background-color:rgb(240,240,240);">Company</h3>
:This is a string value of the standardized company name.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"Company":"'''''string'''''"</code>
|}




Line 177: Line 180:




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


:{| class="alternate01"
==CurrentAddress==
!Protocol !! Syntax
<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.
|JSON||<code>"AddressLine1":"'''''string'''''"</code>
|}


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


:{| class="alternate01"
:{| class="alternate01"
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||<code>"AddressLine2":"'''''string'''''"</code>
|JSON||<code>"Results":"'''''string'''''"</code>
|}
|}




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


:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"PostalCode":"'''''string'''''"</code>
|}




<h3 style="background-color:rgb(240,240,240);">CountryCode</h3>
<h3 style="background-color:rgb(240,240,240);">AddressLine1</h3>
:This is a string value that is the parsed CountryCode element from the input.
: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.
 
:For example:
 
:{| class="alternate01"
!Country !! Code
|-
|United States||US
|-
|Canada||CA
|-
|Philippines||PH
|}
 


:{| class="alternate01"
:{| class="alternate01"
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||<code>"CountryCode":"'''''string'''''"</code>
|JSON||<code>"AddressLine1":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb(240,240,240);">PostBox</h3>
<h3 style="background-color:rgb(240,240,240);">AddressLine2</h3>
:This is a string value that is the parsed PostBox element from the input.
: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.


:{| class="alternate01"
:{| class="alternate01"
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||<code>"PostBox":"'''''string'''''"</code>
|JSON||<code>"AddressLine2":"'''''string'''''"</code>
|}
|}




==Email==
<h3 style="background-color:rgb(240,240,240);">PostalCode</h3>
<h3 style="background-color:rgb(240,240,240);">Results</h3>
:This is a string value that is the standardized contents of the PostalCode element.
: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 Search|Personator Search Result Codes]].


:{| class="alternate01"
:{| class="alternate01"
!Protocol !! Syntax
!Protocol !! Syntax
|-
|-
|JSON||<code>"Results":"'''''string'''''"</code>
|JSON||<code>"PostalCode":"'''''string'''''"</code>
|}
|}




<h3 style="background-color:rgb(240,240,240);">Email Address</h3>
==PreviousAddressRecords==
:This is a string value listing the email address, including any corrections or changes made by Global Email.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"EmailAddress":"'''''string'''''"</code>
|}
 
 
==Phone==
<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.
 
:For a complete list of codes, see [[Result Code Details#Personator Search|Personator Search Result Codes]].
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"Results":"'''''string'''''"</code>
|}




==PhoneRecords==
<h3 style="background-color:rgb(240,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 320: Line 275:
|-
|-
|JSON||<code>"PhoneNumber":"'''''string'''''"</code>
|JSON||<code>"PhoneNumber":"'''''string'''''"</code>
|}
==EmailRecords==
<h3 style="background-color:rgb(240,240,240);">Email Address</h3>
:This is a string value listing the email address, including any corrections or changes made by Global Email.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"EmailAddress":"'''''string'''''"</code>
|}
|}


Revision as of 23:50, 14 March 2017

← Personator Search

Personator Search Navigation
Introduction
Licensing
Input/Output
Request Fields
Response Fields
Examples
REST JSON
Result Codes
Result Code Use
Personator Search 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
Results Response (Base) Results
Transmission Results TransmissionResults
Transmission Reference TransmissionReference
Total Pages TotalPages
Total Records TotalRecords
Version Version
Record ID Record RecordID
Results Results
Full Name FullName
First Name FirstName
Last Name LastName
Date of Birth DateOfBirth
Date of Death DateOfDeath
Current Address CurrentAddress
Previous Address Records PreviousAddressRecords
Phone Records PhoneRecords
Email Records EmailRecords
Address Line 1 CurrentAddress AddressLine1
Suite Suite
City City
State State
Postal Code PostalCode
Plus4 Plus4
Melissa Address Key MelissaAddressKey
Melissa Address Key Base MelissaAddressKeyBase
Move Date MoveDate
Address Line 1 PreviousAddressRecords AddressLine1
Suite Suite
City City
State State
Postal Code PostalCode
Plus4 Plus4
Melissa Address Key MelissaAddressKey
Melissa Address Key Base MelissaAddressKeyBase
Move Date MoveDate
Phone PhoneRecords Phone
Email EmailRecords Email


Response Elements

The following fields are in the response.


Response (Base Level)

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 Search Result Codes.

Protocol Syntax
JSON "Results":"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"



Version

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


Record

Results

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


DateOfBirth

A string value containing the input date of birth returned as is.
Protocol Syntax
JSON "DateOfBirth":"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"


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"


CurrentAddress

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


PostalCode

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


PreviousAddressRecords

PhoneRecords

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"


EmailRecords

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"
Retrieved from "http://wiki.melissadata.com/index.php?title=Personator_Search:Response&oldid=12673"