Personator Consumer:Response: Difference between revisions
No edit summary |
No edit summary |
||
(19 intermediate revisions by the same user not shown) | |||
Line 12: | Line 12: | ||
==Field Names== | ==Field Names== | ||
This is a list of the response field names and their protocol naming conventions. | This is a list of the response field names and their protocol naming conventions. Fields with an asterisk (*) are not available with a credits license and will return a GE29 error code if attempted. | ||
{| class="alternate01 sortable" | {| class="alternate01 sortable" | ||
!Field Name !! Level !! JSON/XML | !Field Name !! Level !! JSON/XML | ||
|- | |- | ||
|Version||rowspan="4" valign="center"|Response||Version | |[[#Version|Version]]||rowspan="4" valign="center"|Response||Version | ||
|- | |- | ||
| | |[[#TransmissionReference|TransmissionReference]]||TransmissionReference | ||
|- | |- | ||
| | |[[#TransmissionResults|TransmissionResults]]||TransmissionResults | ||
|- | |- | ||
| | |[[#TotalRecords|TotalRecords]]||TotalRecords | ||
|- | |- | ||
|AddressDeliveryInstallation||rowspan=" | |[[#AddressDeliveryInstallation|AddressDeliveryInstallation]]||rowspan="134" valign="center"|Record||AddressDeliveryInstallation | ||
|- | |- | ||
|AddressExtras||AddressExtras | |[[#AddressExtras|AddressExtras]]||AddressExtras | ||
|- | |- | ||
|AddressHouseNumber||AddressHouseNumber | |[[#AddressHouseNumber|AddressHouseNumber]]||AddressHouseNumber | ||
|- | |- | ||
|AddressKey||AddressKey | |[[#AddressKey|AddressKey]]||AddressKey | ||
|- | |- | ||
|AddressLine1||AddressLine1 | |[[#AddressLine1|AddressLine1]]||AddressLine1 | ||
|- | |- | ||
|AddressLine2||AddressLine2 | |[[#AddressLine2|AddressLine2]]||AddressLine2 | ||
|- | |- | ||
|AddressLockBox||AddressLockBox | |[[#AddressLockBox|AddressLockBox]]||AddressLockBox | ||
|- | |- | ||
|AddressPostDirection||AddressPostDirection | |[[#AddressPostDirection|AddressPostDirection]]||AddressPostDirection | ||
|- | |- | ||
|AddressPreDirection||AddressPreDirection | |[[#AddressPreDirection|AddressPreDirection]]||AddressPreDirection | ||
|- | |- | ||
|AddressPrivateMailboxName||AddressPrivateMailboxName | |[[#AddressPrivateMailboxName|AddressPrivateMailboxName]]||AddressPrivateMailboxName | ||
|- | |- | ||
|AddressPrivateMailboxRange||AddressPrivateMailboxRange | |[[#AddressPrivateMailboxRange|AddressPrivateMailboxRange]]||AddressPrivateMailboxRange | ||
|- | |- | ||
|AddressRouteService||AddressRouteService | |[[#AddressRouteService|AddressRouteService]]||AddressRouteService | ||
|- | |- | ||
|AddressStreetName||AddressStreetName | |[[#AddressStreetName|AddressStreetName]]||AddressStreetName | ||
|- | |- | ||
|AddressStreetSuffix||AddressStreetSuffix | |[[#AddressStreetSuffix|AddressStreetSuffix]]||AddressStreetSuffix | ||
|- | |- | ||
|AddressSuiteName||AddressSuiteName | |[[#AddressSuiteName|AddressSuiteName]]||AddressSuiteName | ||
|- | |- | ||
|AddressSuiteNumber||AddressSuiteNumber | |[[#AddressSuiteNumber|AddressSuiteNumber]]||AddressSuiteNumber | ||
|- | |- | ||
|AddressTypeCode||AddressTypeCode | |[[#AddressTypeCode|AddressTypeCode]]||AddressTypeCode | ||
|- | |- | ||
|AreaCode||AreaCode | |[[#AreaCode|AreaCode]]||AreaCode | ||
|- | |- | ||
|CBSACode||CBSACode | |[[#CBSACode|CBSACode]]||CBSACode | ||
|- | |- | ||
|CBSADivisionCode||CBSADivisionCode | |[[#CBSADivisionCode|CBSADivisionCode]]||CBSADivisionCode | ||
|- | |- | ||
|CBSADivisionLevel||CBSADivisionLevel | |[[#CBSADivisionLevel|CBSADivisionLevel]]||CBSADivisionLevel | ||
|- | |- | ||
|CBSADivisionTitle||CBSADivisionTitle | |[[#CBSADivisionTitle|CBSADivisionTitle]]||CBSADivisionTitle | ||
|- | |- | ||
|CBSALevel||CBSALevel | |[[#CBSALevel|CBSALevel]]||CBSALevel | ||
|- | |- | ||
|CBSATitle||CBSATitle | |[[#CBSATitle|CBSATitle]]||CBSATitle | ||
|- | |- | ||
|CarrierRoute||CarrierRoute | |[[#CarrierRoute|CarrierRoute]]||CarrierRoute | ||
|- | |- | ||
|CensusBlock||CensusBlock | |[[#CensusBlock|CensusBlock]]||CensusBlock | ||
|- | |- | ||
|CensusKey||CensusKey | |[[#CensusKey|CensusKey]]||CensusKey | ||
|- | |- | ||
|CensusTract||CensusTract | |[[#CensusTract|CensusTract]]||CensusTract | ||
|- | |- | ||
|ChildrenAgeRange||ChildrenAgeRange | |[[#ChildrenAgeRange*|ChildrenAgeRange*]]||ChildrenAgeRange | ||
|- | |- | ||
|City||City | |[[#City|City]]||City | ||
|- | |- | ||
|CityAbbreviation||CityAbbreviation | |[[#CityAbbreviation|CityAbbreviation]]||CityAbbreviation | ||
|- | |- | ||
|CompanyName||CompanyName | |[[#CompanyName|CompanyName]]||CompanyName | ||
|- | |- | ||
|CongressionalDistrict||CongressionalDistrict | |[[#CongressionalDistrict|CongressionalDistrict]]||CongressionalDistrict | ||
|- | |- | ||
|CountryCode||CountryCode | |[[#CountryCode|CountryCode]]||CountryCode | ||
|- | |- | ||
|CountryName||CountryName | |[[#CountryName|CountryName]]||CountryName | ||
|- | |- | ||
|CountyFIPS||CountyFIPS | |[[#CountyFIPS|CountyFIPS]]||CountyFIPS | ||
|- | |- | ||
|CountyName||CountyName | |[[#CountyName|CountyName]]||CountyName | ||
|- | |- | ||
|CountySubdivisionCode||CountySubdivisionCode | |[[#CountySubdivisionCode|CountySubdivisionCode]]||CountySubdivisionCode | ||
|- | |- | ||
|CountySubdivisionName||CountySubdivisionName | |[[#CountySubdivisionName|CountySubdivisionName]]||CountySubdivisionName | ||
|- | |- | ||
|CreditCardUser||CreditCardUser | |[[#CreditCardUser*|CreditCardUser*]]||CreditCardUser | ||
|- | |- | ||
| | |[[#DateLastConfirmed|DateLastConfirmed]]||DateLastConfirmed | ||
|- | |- | ||
| | |[[#DateOfBirth*|DateOfBirth*]]||DateOfBirth | ||
|- | |- | ||
| | |[[#DateOfDeath*|DateOfDeath*]]||DateOfDeath | ||
|- | |- | ||
| | |[[#DeliveryIndicator|DeliveryIndicator]]||DeliveryIndicator | ||
|- | |- | ||
| | |[[#DeliveryPointCheckDigit|DeliveryPointCheckDigit]]||DeliveryPointCheckDigit | ||
|- | |- | ||
| | |[[#DeliveryPointCode|DeliveryPointCode]]||DeliveryPointCode | ||
|- | |- | ||
| | |[[#DemographicsGender*|DemographicsGender*]]||DemographicsGender | ||
|- | |- | ||
| | |[[#DemographicsResults|DemographicsResults]]||DemographicsResults | ||
|- | |- | ||
| | |[[#DistanceAddressToIP|DistanceAddressToIP]]||DistanceAddressToIP | ||
|- | |- | ||
| | |[[#DomainName|DomainName]]||DomainName | ||
|- | |- | ||
| | |[[#Education*|Education*]]||Education | ||
|- | |- | ||
| | |[[#ElementarySchoolDistrictCode|ElementarySchoolDistrictCode]]||ElementarySchoolDistrictCode | ||
|- | |- | ||
| | |[[#ElementarySchoolDistrictName|ElementarySchoolDistrictName]]||ElementarySchoolDistrictName | ||
|- | |- | ||
| | |[[#EmailAddress|EmailAddress]]||EmailAddress | ||
|- | |- | ||
| | |[[#EstimatedHomeValue*|EstimatedHomeValue*]]||EstimatedHomeValue | ||
|- | |- | ||
| | |[[#EthnicCode*|EthnicCode*]]||EthnicCode | ||
|- | |- | ||
| | |[[#EthnicGroup*|EthnicGroup*]]||EthnicGroup | ||
|- | |- | ||
| | |[[#Gender|Gender]]||Gender | ||
|- | |- | ||
| | |[[#Gender2|Gender2]]||Gender2 | ||
|- | |- | ||
| | |[[#HouseholdIncome*|HouseholdIncome*]]||HouseholdIncome | ||
|- | |- | ||
| | |[[#HouseholdSize*|HouseholdSize*]]||HouseholdSize | ||
|- | |- | ||
| | |[[#IPAddress|IPAddress]]||IPAddress | ||
|- | |- | ||
| | |[[#IPCity|IPCity]]||IPCity | ||
|- | |- | ||
| | |[[#IPConnectionSpeed|IPConnectionSpeed]]||IPConnectionSpeed | ||
|- | |- | ||
| | |[[#IPConnectionType|IPConnectionType]]||IPConnectionType | ||
|- | |- | ||
| | |[[#IPContinent|IPContinent]]||IPContinent | ||
|- | |- | ||
| | |[[#IPCountryAbbreviation|IPCountryAbbreviation]]||IPCountryAbbreviation | ||
|- | |- | ||
| | |[[#IPCountryName|IPCountryName]]||IPCountryName | ||
|- | |- | ||
| | |[[#IPDomainName|IPDomainName]]||IPDomainName | ||
|- | |- | ||
| | |[[#IPISPName|IPISPName]]||IPISPName | ||
|- | |- | ||
| | |[[#IPLatitude|IPLatitude]]||IPLatitude | ||
|- | |- | ||
| | |[[#IPLongitude|IPLongitude]]||IPLongitude | ||
|- | |- | ||
| | |[[#IPPostalCode|IPPostalCode]]||IPPostalCode | ||
|- | |- | ||
| | |[[#IPProxyDescription|IPProxyDescription]]||IPProxyDescription | ||
|- | |- | ||
| | |[[#IPProxyType|IPProxyType]]||IPProxyType | ||
|- | |- | ||
| | |[[#IPRegion|IPRegion]]||IPRegion | ||
|- | |- | ||
| | |[[#IPUTC|IPUTC]]||IPUTC | ||
|- | |- | ||
| | |[[#Latitude|Latitude]]||Latitude | ||
|- | |- | ||
| | |[[#LengthOfResidence*|LengthOfResidence*]]||LengthOfResidence | ||
|- | |- | ||
| | |[[#Longitude|Longitude]]||Longitude | ||
|- | |- | ||
| | |[[#MailboxName|MailboxName]]||MailboxName | ||
|- | |- | ||
| | |[[#MaritalStatus*|MaritalStatus*]]||MaritalStatus | ||
|- | |- | ||
| | |[[#MelissaAddressKey|MelissaAddressKey]]||MelissaAddressKey | ||
|- | |- | ||
| | |[[#MelissaAddressKeyBase|MelissaAddressKeyBase]]||MelissaAddressKeyBase | ||
|- | |- | ||
| | |[[#MelissaIdentityKey|MelissaIdentityKey]]||MelissaIdentityKey | ||
|- | |- | ||
| | |[[#MoveDate|MoveDate]]||MoveDate | ||
|- | |- | ||
| | |[[#NameFirst|NameFirst]]||NameFirst | ||
|- | |- | ||
| | |[[#NameFirst2|NameFirst2]]||NameFirst2 | ||
|- | |- | ||
| | |[[#NameFull|NameFull]]||NameFull | ||
|- | |- | ||
| | |[[#NameLast|NameLast]]||NameLast | ||
|- | |- | ||
| | |[[#NameLast2|NameLast2]]||NameLast2 | ||
|- | |- | ||
| | |[[#NameMiddle|NameMiddle]]||NameMiddle | ||
|- | |- | ||
| | |[[#NameMiddle2|NameMiddle2]]||NameMiddle2 | ||
|- | |- | ||
| | |[[#NamePrefix|NamePrefix]]||NamePrefix | ||
|- | |- | ||
| | |[[#NamePrefix2|NamePrefix2]]||NamePrefix2 | ||
|- | |- | ||
| | |[[#NameSuffix|NameSuffix]]||NameSuffix | ||
|- | |- | ||
| | |[[#NameSuffix2|NameSuffix2]]||NameSuffix2 | ||
|- | |- | ||
| | |[[#NewAreaCode|NewAreaCode]]||NewAreaCode | ||
|- | |- | ||
| | |[[#Occupation*|Occupation*]]||Occupation | ||
|- | |- | ||
| | |[[#OwnRent*|OwnRent*]]||OwnRent | ||
|- | |- | ||
| | |[[#PhoneCountryCode|PhoneCountryCode]]||PhoneCountryCode | ||
|- | |- | ||
| | |[[#PhoneCountryName|PhoneCountryName]]||PhoneCountryName | ||
|- | |- | ||
| | |[[#PhoneExtension|PhoneExtension]]||PhoneExtension | ||
|- | |- | ||
| | |[[#PhoneNumber|PhoneNumber]]||PhoneNumber | ||
|- | |- | ||
| | |[[#PhonePrefix|PhonePrefix]]||PhonePrefix | ||
|- | |- | ||
| | |[[#PhoneSuffix|PhoneSuffix]]||PhoneSuffix | ||
|- | |- | ||
| | |[[#PlaceCode|PlaceCode]]||PlaceCode | ||
|- | |- | ||
| | |[[#PlaceName|PlaceName]]||PlaceName | ||
|- | |- | ||
| | |[[#Plus4|Plus4]]||Plus4 | ||
|- | |- | ||
|UrbanizationName||UrbanizationName | |[[#PoliticalParty*|PoliticalParty*]]||PoliticalParty | ||
|- | |||
|[[#PostalCode|PostalCode]]||PostalCode | |||
|- | |||
|[[#PresenceOfChildren*|PresenceOfChildren*]]||PresenceOfChildren | |||
|- | |||
|[[#PresenceOfSenior*|PresenceOfSenior*]]||PresenceOfSenior | |||
|- | |||
|[[#PrivateMailBox|PrivateMailBox]]||PrivateMailBox | |||
|- | |||
|[[#RecordID|RecordID]]||RecordID | |||
|- | |||
|[[#Results|Results]]||Results | |||
|- | |||
|[[#Salutation|Salutation]]||Salutation | |||
|- | |||
|[[#SecondarySchoolDistrictCode|SecondarySchoolDistrictCode]]||SecondarySchoolDistrictCode | |||
|- | |||
|[[#SecondarySchoolDistrictName|SecondarySchoolDistrictName]]||SecondarySchoolDistrictName | |||
|- | |||
|[[#State|State]]||State | |||
|- | |||
|[[#StateDistrictLower|StateDistrictLower]]||StateDistrictLower | |||
|- | |||
|[[#StateDistrictUpper|StateDistrictUpper]]||StateDistrictUpper | |||
|- | |||
|[[#StateName|StateName]]||StateName | |||
|- | |||
|[[#Suite|Suite]]||Suite | |||
|- | |||
|[[#TopLevelDomain|TopLevelDomain]]||TopLevelDomain | |||
|- | |||
|[[#UTC|UTC]]||UTC | |||
|- | |||
|[[#UnifiedSchoolDistrictCode|UnifiedSchoolDistrictCode]]||UnifiedSchoolDistrictCode | |||
|- | |||
|[[#UnifiedSchoolDistrictName|UnifiedSchoolDistrictName]]||UnifiedSchoolDistrictName | |||
|- | |||
|[[#UrbanizationName|UrbanizationName]]||UrbanizationName | |||
|} | |} | ||
Line 262: | Line 300: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">TransmissionReference</h3> | ||
:This is a string value that serves as a unique identifier for this set of records. It is returned as sent by the Request Array, allowing you to match the Response to the Request. | :This is a string value that serves as a unique identifier for this set of records. It is returned as sent by the Request Array, allowing you to match the Response to the Request. | ||
Line 274: | Line 312: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">TransmissionResults</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|Personator Result Codes]]. | :For a complete list of error codes, see [[Result Code Details#Personator Consumer|Personator Consumer Result Codes]]. | ||
:{| class="alternate01" | :{| class="alternate01" | ||
Line 288: | Line 326: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">TotalRecords</h3> | ||
:Displays the total number of records returned. | :Displays the total number of records returned. | ||
Line 314: | Line 352: | ||
Each of the following elements are returned for each record in the Response Array. | Each of the following elements are returned for each record in the Response Array. | ||
<h3 style="background-color:rgb(240,240,240);">AddressDeliveryInstallation</h3> | |||
:Canada Only. | |||
:Returns the parsed delivery installation for the address entered in the AddressLine field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"AddressDeliveryInstallation":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><AddressDeliveryInstallation>'''''string'''''</AddressDeliveryInstallation></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">AddressExtras</h3> | |||
:Any extra information that does not fit in the AddressLine fields. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"AddressExtras":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><AddressExtras>'''''string'''''</AddressExtras></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">AddressHouseNumber</h3> | |||
:Returns the parsed house number for the address entered in the AddressLine field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"AddressHouseNumber":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><AddressHouseNumber>'''''string'''''</AddressHouseNumber></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">AddressKey</h3> | |||
:Returns a unique identifier for an address. This key can be used with other current and future Melissa services. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"AddressKey":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><AddressKey>'''''string'''''</AddressKey></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">AddressLine1</h3> | <h3 style="background-color:rgb(240,240,240);">AddressLine1</h3> | ||
: | :Returns the address entered in the AddressLine field. If two addresses were entered and only one is valid, the valid address is returned instead. This includes the suite and private mailbox. | ||
:{| class="alternate01" | :{| class="alternate01" | ||
Line 329: | Line 417: | ||
<h3 style="background-color:rgb(240,240,240);">AddressLine2</h3> | <h3 style="background-color:rgb(240,240,240);">AddressLine2</h3> | ||
: | :If two addresses are passed into the AddressLine field, the second address is returned here. If only one of two addresses is valid, the valid address will be returned in Address Line 1. | ||
:{| class="alternate01" | :{| class="alternate01" | ||
Line 340: | Line 428: | ||
== | <h3 style="background-color:rgb(240,240,240);">AddressLockBox</h3> | ||
<h3 style="background-color:rgb(240,240,240);"> | :Canada Only. | ||
: | |||
:Returns the parsed lock box number for the address entered in the AddressLine field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"AddressLockBox":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><AddressLockBox>'''''string'''''</AddressLockBox></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">AddressPostDirection</h3> | |||
:Returns the parsed post-direction for the address entered in the AddressLine field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"AddressPostDirection":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><AddressPostDirection>'''''string'''''</AddressPostDirection></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">AddressPreDirection</h3> | |||
:Returns the parsed pre-direction for the address entered in the AddressLine field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"AddressPreDirection":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><AddressPreDirection>'''''string'''''</AddressPreDirection></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">AddressPrivateMailboxName</h3> | |||
:Returns the parsed private mailbox name for the address entered in the AddressLine field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"AddressPrivateMailboxName":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><AddressPrivateMailboxName>'''''string'''''</AddressPrivateMailboxName></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">AddressPrivateMailboxRange</h3> | |||
:Returns the parsed private mailbox range for the address entered in the AddressLine field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"AddressPrivateMailboxRange":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><AddressPrivateMailboxRange>'''''string'''''</AddressPrivateMailboxRange></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">AddressRouteService</h3> | |||
:Canada Only. | |||
:Returns the parsed route service number for the address entered in the AddressLine field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"AddressRouteService":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><AddressRouteService>'''''string'''''</AddressRouteService></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">AddressStreetName</h3> | |||
:Returns the parsed street name for the address entered in the AddressLine field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"AddressStreetName":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><AddressStreetName>'''''string'''''</AddressStreetName></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">AddressStreetSuffix</h3> | |||
:Returns the parsed street suffix for the address entered in the AddressLine field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"AddressStreetSuffix":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><AddressStreetSuffix>'''''string'''''</AddressStreetSuffix></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">AddressSuiteName</h3> | |||
:Returns the parsed suite name for the address entered in the AddressLine field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"AddressSuiteName":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><AddressSuiteName>'''''string'''''</AddressSuiteName></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">AddressSuiteNumber</h3> | |||
:Returns the parsed suite number for the address entered in the AddressLine field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"AddressSuiteNumber":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><AddressSuiteNumber>'''''string'''''</AddressSuiteNumber></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">AddressTypeCode</h3> | |||
:Returns a code for the address type in the AddressLine field. Please see the [[Result Code Details#Personator Consumer|Result Code Details]] for the list of possible codes. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"AddressTypeCode":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><AddressTypeCode>'''''string'''''</AddressTypeCode></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">AreaCode</h3> | |||
:Returns the parsed area code for the phone number entered in the Phone field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"AreaCode":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><AreaCode>'''''string'''''</AreaCode></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CBSACode</h3> | |||
:Census Bureau’s Core Based Statistical Area (CBSA). Returns the 5-digit code for the CBSA associated with the requested record. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CBSACode":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CBSACode>'''''string'''''</CBSACode></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CBSADivisionCode</h3> | |||
:Returns the code for a division associated with the requested record, if any. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CBSADivisionCode":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CBSADivisionCode>'''''string'''''</CBSADivisionCode></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CBSADivisionLevel</h3> | |||
:Returns whether the CBSA division, if any, is metropolitan or micropolitan. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CBSADivisionLevel":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CBSADivisionLevel>'''''string'''''</CBSADivisionLevel></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CBSADivisionTitle</h3> | |||
:Returns the title for the CBSA division, if any. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CBSADivisionTitle":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CBSADivisionTitle>'''''string'''''</CBSADivisionTitle></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CBSALevel</h3> | |||
:Returns whether the CBSA is metropolitan or micropolitan. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CBSALevel":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CBSALevel>'''''string'''''</CBSALevel></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CBSATitle</h3> | |||
:Returns the title for the CBSA. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CBSATitle":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CBSATitle>'''''string'''''</CBSATitle></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CarrierRoute</h3> | |||
:Returns a 4-character code defining the carrier route for this record. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CarrierRoute":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CarrierRoute>'''''string'''''</CarrierRoute></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CensusBlock</h3> | |||
:Returns a 4-digit string containing the census block number associated with the requested record. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CensusBlock":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CensusBlock>'''''string'''''</CensusBlock></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CensusKey</h3> | |||
:Returns a 15 digit string containing the concatenated County FIPS, Census Tract and Census Block. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CensusKey":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CensusKey>'''''string'''''</CensusKey></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CensusTract</h3> | |||
:Returns a 4-to 6-digit string containing the census tract number associated with the requested record. | |||
:Census tracts are small subdivisions of a county. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CensusTract":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CensusTract>'''''string'''''</CensusTract></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">ChildrenAgeRange*</h3> | |||
:Returns the age range of children present in the household. | |||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01" | |||
!Value | |||
|- | |||
|Blank | |||
|- | |||
|0-2 | |||
|- | |||
|3-5 | |||
|- | |||
|6-10 | |||
|- | |||
|11-15 | |||
|- | |||
|16-17 | |||
|} | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"ChildrenAgeRange":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><ChildrenAgeRange>'''''string'''''</ChildrenAgeRange></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">City</h3> | |||
:Returns the city entered in the City field. | |||
:{| class="alternate01" | :{| class="alternate01" | ||
!Protocol !! Syntax | !Protocol !! Syntax | ||
|- | |- | ||
|JSON||<code>" | |JSON||<code>"City":"'''''string'''''"</code> | ||
|- | |- | ||
|SOAP/XML||<code>< | |SOAP/XML||<code><City>'''''string'''''</City></code> | ||
|} | |} | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">CityAbbreviation</h3> | ||
:This is a string value | :Returns an abbreviation for the city entered in the City field, if any. | ||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CityAbbreviation":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CityAbbreviation>'''''string'''''</CityAbbreviation></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CompanyName</h3> | |||
:Returns the company name. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CompanyName":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CompanyName>'''''string'''''</CompanyName></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CongressionalDistrict</h3> | |||
:Returns the 2-digit congressional district that belongs to the requested record. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CongressionalDistrict":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CongressionalDistrict>'''''string'''''</CongressionalDistrict></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CountryCode</h3> | |||
:Returns the country code for the country in the Country field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CountryCode":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CountryCode>'''''string'''''</CountryCode></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CountryName</h3> | |||
:Returns the country name for the record. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CountryName":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CountryName>'''''string'''''</CountryName></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CountyFIPS</h3> | |||
:Returns the FIPS code for the county in the County field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CountyFIPS":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CountyFIPS>'''''string'''''</CountyFIPS></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CountyName</h3> | |||
:Returns the county name. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CountyName":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CountyName>'''''string'''''</CountyName></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CountySubdivisionCode</h3> | |||
:Returns a 5 digit string representing the County Subdivision Code for the requested record. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CountySubdivisionCode":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CountySubdivisionCode>'''''string'''''</CountySubdivisionCode></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CountySubdivisionName</h3> | |||
:Returns the County Subdivision Name for the requested record. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CountySubdivisionName":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CountySubdivisionName>'''''string'''''</CountySubdivisionName></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">CreditCardUser*</h3> | |||
:Returns whether the user has a credit card or not. | |||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01" | |||
!Value | |||
|- | |||
|Blank | |||
|- | |||
|Yes | |||
|- | |||
|No | |||
|} | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"CreditCardUser":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><CreditCardUser>'''''string'''''</CreditCardUser></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">DateLastConfirmed</h3> | |||
:Returns the date this record was last seen updated from one of Personator’s Data Sources. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"DateLastConfirmed":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><DateLastConfirmed>'''''string'''''</DateLastConfirmed></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">DateOfBirth*</h3> | |||
:Returns the date of birth in the format YYYYMM. Accuracy is only to the month. | |||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"DateOfBirth":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><DateOfBirth>'''''string'''''</DateOfBirth></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">DateOfDeath*</h3> | |||
:Returns the full date of death in the format YYYYMMDD. | |||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"DateOfDeath":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><DateOfDeath>'''''string'''''</DateOfDeath></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">DeliveryIndicator</h3> | |||
:Returns an indicator of whether an address is a business address or residential address. | |||
:{| class="alternate01" | |||
!Value!!Definition | |||
|- | |||
|R||Residential | |||
|- | |||
|B||Business | |||
|- | |||
|U||Unknown | |||
|} | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"DeliveryIndicator":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><DeliveryIndicator>'''''string'''''</DeliveryIndicator></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">DeliveryPointCheckDigit</h3> | |||
:Returns a string value containing the 1-digit delivery point check digit. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"DeliveryPointCheckDigit":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><DeliveryPointCheckDigit>'''''string'''''</DeliveryPointCheckDigit></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">DeliveryPointCode</h3> | |||
:Returns a string value containing the 2-digit delivery point code. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"DeliveryPointCode":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><DeliveryPointCode>'''''string'''''</DeliveryPointCode></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">DemographicsGender*</h3> | |||
:Returns gender based on demographics data. | |||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01" | |||
!Value | |||
|- | |||
|Unknown | |||
|- | |||
|Male | |||
|- | |||
|Female | |||
|- | |||
|Neutral | |||
|} | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"DemographicsGender":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><DemographicsGender>'''''string'''''</DemographicsGender></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">DemographicsResults</h3> | |||
:If any demographics are enabled, Demographics Results will return a comma delimited string containing all the results of the demographics combined. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"DemographicsResults":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><DemographicsResults>'''''string'''''</DemographicsResults></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">DistanceAddressToIP</h3> | |||
:This is the distance in miles between the latitude and longitude of the physical location of the IP Addressn and the latitude and longitude of the input Address. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"DistanceAddressToIP":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><DistanceAddressToIP>'''''string'''''</DistanceAddressToIP></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">DomainName</h3> | |||
:Returns the parsed domain name for the email entered in the Email field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"DomainName":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><DomainName>'''''string'''''</DomainName></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">Education*</h3> | |||
:Returns the highest level of education completed by an individual. | |||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01" | |||
!Value | |||
|- | |||
|Blank | |||
|- | |||
|High School | |||
|- | |||
|College | |||
|- | |||
|Graduate School | |||
|- | |||
|Vocational/Technical School | |||
|} | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"Education":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><Education>'''''string'''''</Education></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">ElementarySchoolDistrictCode</h3> | |||
:Returns a 5 digit string representing the Elementary School District Code for the requested record. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"ElementarySchoolDistrictCode":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><ElementarySchoolDistrictCode>'''''string'''''</ElementarySchoolDistrictCode></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">ElementarySchoolDistrictName</h3> | |||
:Returns the Elementary School District Name for the requested record. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"ElementarySchoolDistrictName":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><ElementarySchoolDistrictName>'''''string'''''</ElementarySchoolDistrictName></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">EmailAddress</h3> | |||
:Returns the email address entered in the Email field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"EmailAddress":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><EmailAddress>'''''string'''''</EmailAddress></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">EstimatedHomeValue*</h3> | |||
:The estimated value of the home, given in U.S. Dollars. | |||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"EstimatedHomeValue":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><EstimatedHomeValue>'''''string'''''</EstimatedHomeValue></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">EthnicCode*</h3> | |||
:Returns an individual’s specific ethnicity. | |||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01" | |||
!Value | |||
|- | |||
|Afghan | |||
|- | |||
|African-American | |||
|- | |||
|Albanian | |||
|- | |||
|Aleutian | |||
|- | |||
|Algerian | |||
|- | |||
|American Indian | |||
|- | |||
|Arabian | |||
|- | |||
|Armenian | |||
|- | |||
|Ashanti | |||
|- | |||
|Australian | |||
|- | |||
|Austrian | |||
|- | |||
|Azerbaijani | |||
|- | |||
|Bahrain | |||
|- | |||
|Bangladesh | |||
|- | |||
|Basotho | |||
|- | |||
|Basque | |||
|- | |||
|Belgian | |||
|- | |||
|Belorussian | |||
|- | |||
|Beninese | |||
|- | |||
|Bhutanese | |||
|- | |||
|Black African | |||
|- | |||
|Bosnian Muslim | |||
|- | |||
|Botswanian | |||
|- | |||
|Bulgarian | |||
|- | |||
|Burkina Faso | |||
|- | |||
|Burundian | |||
|- | |||
|Cameroonian | |||
|- | |||
|Caribbean African American | |||
|- | |||
|Central African Republic | |||
|- | |||
|Chadian | |||
|- | |||
|Chechnyan | |||
|- | |||
|Chinese | |||
|- | |||
|Comoros | |||
|- | |||
|Congolese | |||
|- | |||
|Croatian | |||
|- | |||
|Czech | |||
|- | |||
|Danish | |||
|- | |||
|Djiboutian | |||
|- | |||
|Dutch | |||
|- | |||
|Egyptian | |||
|- | |||
|English | |||
|- | |||
|Equatorial Guinea | |||
|- | |||
|Estonian | |||
|- | |||
|Ethiopian | |||
|- | |||
|Fiji | |||
|- | |||
|Finnish | |||
|- | |||
|French | |||
|- | |||
|Gabon | |||
|- | |||
|Gambian | |||
|- | |||
|Georgian | |||
|- | |||
|German | |||
|- | |||
|Ghanaian | |||
|- | |||
|Greek | |||
|- | |||
|Guinea Bissau | |||
|- | |||
|Guinean | |||
|- | |||
|Guyanese | |||
|- | |||
|Hausa | |||
|- | |||
|Hawaiian | |||
|- | |||
|Icelandic | |||
|- | |||
|Indian | |||
|- | |||
|Indonesian | |||
|- | |||
|Iraqi | |||
|- | |||
|Irish | |||
|- | |||
|Italian | |||
|- | |||
|Ivorian | |||
|- | |||
|Japanese | |||
|- | |||
|Jewish | |||
|- | |||
|Kampuchean/Khmer(Cambodian) | |||
|- | |||
|Kazakhstan | |||
|- | |||
|Kenyan | |||
|- | |||
|Kirghizia | |||
|- | |||
|Korean | |||
|- | |||
|Kurdish | |||
|- | |||
|Kuwaiti | |||
|- | |||
|Kyrgyzstani | |||
|- | |||
|Laotian | |||
|- | |||
|Latvian | |||
|- | |||
|Lesotho | |||
|- | |||
|Liberian | |||
|- | |||
|Libyan | |||
|- | |||
|Liechtenstein | |||
|- | |||
|Lithuanian | |||
|- | |||
|Luxembourgian | |||
|- | |||
|Macedonia | |||
|- | |||
|Madagascan | |||
|- | |||
|Malawian | |||
|- | |||
|Malaysian | |||
|- | |||
|Maldivian & Tongan | |||
|- | |||
|Malian | |||
|- | |||
|Maltese | |||
|- | |||
|Manx | |||
|- | |||
|Mauritanian | |||
|- | |||
|Moldovan | |||
|- | |||
|Mongolian | |||
|- | |||
|Moroccan | |||
|- | |||
|Mozambican | |||
|- | |||
|Multi-Ethnic | |||
|- | |||
|Myanmar (Burmese) | |||
|- | |||
|Namibian | |||
|- | |||
|Nepalese | |||
|- | |||
|New Zealand | |||
|- | |||
|Niger | |||
|- | |||
|Nigerian | |||
|- | |||
|Norwegian | |||
|- | |||
|Other Oriental | |||
|- | |||
|Pakistani | |||
|- | |||
|Papua New Guinean | |||
|- | |||
|Persian | |||
|- | |||
|Philippine | |||
|- | |||
|Pili | |||
|- | |||
|Polish | |||
|- | |||
|Portuguese | |||
|- | |||
|Qatari | |||
|- | |||
|Romanian | |||
|- | |||
|Russian | |||
|- | |||
|Saudi | |||
|- | |||
|Scottish | |||
|- | |||
|Senegalese | |||
|- | |||
|Serbian | |||
|- | |||
|Seychelles | |||
|- | |||
|Sierre Leone | |||
|- | |||
|Sinhalese (Sri-Lankan) | |||
|- | |||
|Slovakian | |||
|- | |||
|Slovenian | |||
|- | |||
|Somalian | |||
|- | |||
|South African | |||
|- | |||
|Spanish | |||
|- | |||
|Sudanese | |||
|- | |||
|Surinamese | |||
|- | |||
|Swedish | |||
|- | |||
|Swiss | |||
|- | |||
|Syrian | |||
|- | |||
|Tajik | |||
|- | |||
|Tajikistan | |||
|- | |||
|Tanzanian | |||
|- | |||
|Telugan | |||
|- | |||
|Thai | |||
|- | |||
|Tibetan | |||
|- | |||
|Togolese | |||
|- | |||
|Tonga | |||
|- | |||
|Tunisian | |||
|- | |||
|Turkish | |||
|- | |||
|Turkmenistan | |||
|- | |||
|Ugandan | |||
|- | |||
|Ukrainian | |||
|- | |||
|Uzbekistan | |||
|- | |||
|Vanuatuan | |||
|- | |||
|Vietnamese | |||
|- | |||
|Welsh | |||
|- | |||
|Western Samoan | |||
|- | |||
|Xhosa | |||
|- | |||
|Yemeni | |||
|- | |||
|Zairean | |||
|- | |||
|Zambian | |||
|- | |||
|Zimbabwean | |||
|- | |||
|Zulu | |||
|} | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"EthnicCode":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><EthnicCode>'''''string'''''</EthnicCode></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">EthnicGroup*</h3> | |||
:Returns the grouped category for a person’s ethnicity. This is a more generalized grouping compared to Ethnic Codes. | |||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01 collapsible collapsed" | |||
!Value | |||
|- | |||
|Southeast Asian | |||
|- | |||
|Central & Southwest Asian | |||
|- | |||
|Eastern European | |||
|- | |||
|All African American Ethnic Groups | |||
|- | |||
|Middle Eastern | |||
|- | |||
|Jewish | |||
|- | |||
|Mediterranean | |||
|- | |||
|Native American | |||
|- | |||
|Far Eastern | |||
|- | |||
|Polynesian | |||
|- | |||
|Scandinavian | |||
|- | |||
|Other | |||
|- | |||
|Western European | |||
|- | |||
|Hispanic | |||
|} | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"EthnicGroup":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><EthnicGroup>'''''string'''''</EthnicGroup></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">Gender</h3> | |||
:Returns a gender for the name in the FullName field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"Gender":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><Gender>'''''string'''''</Gender></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">Gender2</h3> | |||
:Only used if 2 names are in the FullName field. Returns a gender for the second name in the FullName field. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"Gender2":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><Gender2>'''''string'''''</Gender2></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">HouseholdIncome*</h3> | |||
:Returns the range of the income of the returned individual for the household. | |||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"HouseholdIncome":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><HouseholdIncome>'''''string'''''</HouseholdIncome></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">HouseholdSize*</h3> | |||
:Returns the number of occupants in the household. | |||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01 collapsible collapsed" | |||
!Value | |||
|- | |||
|Blank | |||
|- | |||
|1 | |||
|- | |||
|2 | |||
|- | |||
|3 | |||
|- | |||
|4 | |||
|- | |||
|5 | |||
|- | |||
|6 | |||
|- | |||
|7 | |||
|- | |||
|8 | |||
|- | |||
|9 | |||
|} | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"HouseholdSize":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><HouseholdSize>'''''string'''''</HouseholdSize></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">IPAddress</h3> | |||
:The IP address being looked up. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"IPAddress":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><IPAddress>'''''string'''''</IPAddress></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">IPCity</h3> | |||
:The city where the IP address is located. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"IPCity":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><IPCity>'''''string'''''</IPCity></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">IPConnectionSpeed</h3> | |||
:The connection speed associated with this IP address. | |||
:{| class="alternate01" | |||
!Value | |||
|- | |||
|dialup | |||
|- | |||
|broadband | |||
|- | |||
|ultra broadband | |||
|} | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"IPConnectionSpeed":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><IPConnectionSpeed>'''''string'''''</IPConnectionSpeed></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">IPConnectionType</h3> | |||
:The type of connection used by this IP address. | |||
:{| class="alternate01" | |||
!Value | |||
|- | |||
|dialup | |||
|- | |||
|wired | |||
|- | |||
|wifi | |||
|- | |||
|mobile | |||
|- | |||
|satellite | |||
|} | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"IPConnectionType":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><IPConnectionType>'''''string'''''</IPConnectionType></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">IPContinent</h3> | |||
:The continent where the IP address is located. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"IPContinent":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><IPContinent>'''''string'''''</IPContinent></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">IPCountryAbbreviation</h3> | |||
:The ISO 3166-1 alpha-2 country code of the country where the IP address is located. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"IPCountryAbbreviation":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><IPCountryAbbreviation>'''''string'''''</IPCountryAbbreviation></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">IPCountryName</h3> | |||
:The full name of the country where the IP address is located. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"IPCountryName":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><IPCountryName>'''''string'''''</IPCountryName></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">IPDomainName</h3> | |||
:The domain name associated with this IP address. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"IPDomainName":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><IPDomainName>'''''string'''''</IPDomainName></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">IPISPName</h3> | |||
:The name of the Internet Service Provider associated with the IP Address. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"IPISPName":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><IPISPName>'''''string'''''</IPISPName></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">IPLatitude</h3> | |||
:The latitude for the IP address. This usually points to the IP Address's postal code. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"IPLatitude":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><IPLatitude>'''''string'''''</IPLatitude></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">IPLongitude</h3> | |||
:The longitude for the IP address. This usually points to the IP Address's postal code. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"IPLongitude":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><IPLongitude>'''''string'''''</IPLongitude></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">IPPostalCode</h3> | |||
:The postal code where the IP Address is located. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"IPPostalCode":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><IPPostalCode>'''''string'''''</IPPostalCode></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">IPProxyDescription</h3> | |||
:Additional Details for the Proxy Type returned. | |||
:{| class="alternate01" | |||
!Value | |||
|- | |||
|Tor-exit | |||
|- | |||
|Tor-relay | |||
|- | |||
|AOL | |||
|- | |||
|Cloud | |||
|- | |||
|DNS | |||
|- | |||
|VPN | |||
|- | |||
|Web-Browser | |||
|} | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"IPProxyDescription":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><IPProxyDescription>'''''string'''''</IPProxyDescription></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">IPProxyType</h3> | |||
:The type of proxy for an IP Address. | |||
:{| class="alternate01" | |||
!Value!!Definition | |||
|- | |||
|Anonymous||The IP address is a proxy and the actual IP address of the end user is not available. | |||
|- | |||
|Transparent||The IP address is a proxy, but the originating IP address of the end user can be detected by inspecting the HTTP headers, however, this can easily be spoofed | |||
|- | |||
|Hosting||The IP address belongs to a hosting facility or cloud provider and may be used as a proxy because an end user is not typically located in a hosting facility. These IP addresses may be rented per service agreement with the hosting facility and easily disposed. | |||
|- | |||
|Corporate||The IP address is registered to a specific location with end users sharing a single IP address. A typical example is of end users behind a router using Network Address Translation. Each user will appear to the world as coming from the same IP address | |||
|- | |||
|Public||The address is a known public proxy allowing multiple users to proxy their data from a location allowing public Internet access. | |||
|- | |||
|Edu||The IP address is from a known educational institution. | |||
|- | |||
|AOL||The IP address is an AOL proxy. | |||
|- | |||
|Blank||Not a known proxy. | |||
|} | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"IPProxyType":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><IPProxyType>'''''string'''''</IPProxyType></code> | |||
|} | |||
:The | <h3 style="background-color:rgb(240,240,240);">IPRegion</h3> | ||
:The region where the IP address is located, specific meaning varies from country to country. For IPs in the US this field returns the state that the IP is located within. | |||
:{| class="alternate01" | :{| class="alternate01" | ||
!Protocol !! Syntax | !Protocol !! Syntax | ||
|- | |- | ||
|JSON||<code>" | |JSON||<code>"IPRegion":"'''''string'''''"</code> | ||
|- | |- | ||
|SOAP/XML||<code>< | |SOAP/XML||<code><IPRegion>'''''string'''''</IPRegion></code> | ||
|} | |} | ||
<h3 style="background-color:rgb(240,240,240);">IPUTC</h3> | |||
:The GMT offset for the area where the IP address is located. | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"IPUTC":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><IPUTC>'''''string'''''</IPUTC></code> | |||
|} | |||
Line 383: | Line 1,816: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">LengthOfResidence*</h3> | ||
:Returns the range of the individual's length of residency in their current address. | |||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01" | :{| class="alternate01" | ||
Line 445: | Line 1,880: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">MailboxName</h3> | ||
:Returns the parsed mailbox name for the email entered in the Email field. | :Returns the parsed mailbox name for the email entered in the Email field. | ||
Line 457: | Line 1,892: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">MaritalStatus*</h3> | ||
:Returns the individual's marital status. | :Returns the individual's marital status. | ||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01" | :{| class="alternate01" | ||
Line 469: | Line 1,906: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">MelissaAddressKey</h3> | ||
:Returns a unique key associated with an address. | :Returns a unique key associated with an address. | ||
Line 481: | Line 1,918: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">MelissaAddressKeyBase</h3> | ||
:Returns a unique key associated with a building containing multiple suites/apartments. | :Returns a unique key associated with a building containing multiple suites/apartments. | ||
Line 493: | Line 1,930: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">MelissaIdentityKey</h3> | ||
:Returns a unique key associated with an individual. In order to retrieve the MelissaIdentityKey, the Check and Verify Actions must both be enabled: | |||
<pre class="indent">"Actions":"Check,Verify"</pre> | |||
:{| class="alternate01" | |||
!Protocol !! Syntax | |||
|- | |||
|JSON||<code>"MelissaIdentityKey":"'''''string'''''"</code> | |||
|- | |||
|SOAP/XML||<code><MelissaIdentityKey>'''''string'''''</MelissaIdentityKey></code> | |||
|} | |||
<h3 style="background-color:rgb(240,240,240);">MoveDate</h3> | |||
:Returns the date associated with the move address. | :Returns the date associated with the move address. | ||
Line 501: | Line 1,952: | ||
|JSON||<code>"MoveDate":"'''''string'''''"</code> | |JSON||<code>"MoveDate":"'''''string'''''"</code> | ||
|- | |- | ||
|SOAP/XML||<code><MoveDate>'''''string'''''</> | |SOAP/XML||<code><MoveDate>'''''string'''''</MoveDate></code> | ||
|} | |} | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">NameFirst</h3> | ||
:Returns the first name in the FullName field. | :Returns the first name in the FullName field. | ||
Line 517: | Line 1,968: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">NameFirst2</h3> | ||
:Only used if 2 names are in the FullName field. Returns the second name in the FullName field. | :Only used if 2 names are in the FullName field. Returns the second name in the FullName field. | ||
Line 529: | Line 1,980: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">NameFull</h3> | ||
:Returns the full name for the record. | :Returns the full name for the record. | ||
Line 541: | Line 1,992: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">NameLast</h3> | ||
:Returns the last name in the FullName field. | :Returns the last name in the FullName field. | ||
Line 553: | Line 2,004: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">NameLast2</h3> | ||
:Only used if 2 names are in the FullName field. Returns a last name for the second name in the FullName field. | :Only used if 2 names are in the FullName field. Returns a last name for the second name in the FullName field. | ||
Line 565: | Line 2,016: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">NameMiddle</h3> | ||
:Returns a middle name for the name in the FullName field. | :Returns a middle name for the name in the FullName field. | ||
Line 577: | Line 2,028: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">NameMiddle2</h3> | ||
:Only used if 2 names are in the FullName field. Returns a middle name for the second name in the FullName field. | :Only used if 2 names are in the FullName field. Returns a middle name for the second name in the FullName field. | ||
Line 589: | Line 2,040: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">NamePrefix</h3> | ||
:Returns a prefix for the name in the FullName field. | :Returns a prefix for the name in the FullName field. | ||
Line 601: | Line 2,052: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">NamePrefix2</h3> | ||
:Only used if 2 names are in the FullName field. Returns a prefix for the second name in the FullName field. | :Only used if 2 names are in the FullName field. Returns a prefix for the second name in the FullName field. | ||
Line 613: | Line 2,064: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">NameSuffix</h3> | ||
:Returns a suffix for the name in the FullName field. | :Returns a suffix for the name in the FullName field. | ||
Line 625: | Line 2,076: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">NameSuffix2</h3> | ||
:Only used if 2 names are in the FullName field. Returns a suffix for the second name in the FullName field. | :Only used if 2 names are in the FullName field. Returns a suffix for the second name in the FullName field. | ||
Line 637: | Line 2,088: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">NewAreaCode</h3> | ||
:Returns the parsed new area code for the phone number entered in the Phone field. | :Returns the parsed new area code for the phone number entered in the Phone field. | ||
Line 649: | Line 2,100: | ||
<h3 style="background-color:rgb(240,240,240);">Occupation</h3> | <h3 style="background-color:rgb(240,240,240);">Occupation*</h3> | ||
:Returns the category for the individual's occupation. | :Returns the category for the individual's occupation. | ||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01" | :{| class="alternate01" | ||
Line 709: | Line 2,162: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">OwnRent*</h3> | ||
:Returns the individual's status as owner or renter of the property. | :Returns the individual's status as owner or renter of the property. | ||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01" | :{| class="alternate01" | ||
Line 735: | Line 2,190: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">PhoneCountryCode</h3> | ||
:Returns the 2 character country code for the phone number entered in the Phone field. | :Returns the 2 character country code for the phone number entered in the Phone field. | ||
Line 747: | Line 2,202: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">PhoneCountryName</h3> | ||
:Returns the full country name for the phone number entered in the Phone field. | :Returns the full country name for the phone number entered in the Phone field. | ||
Line 759: | Line 2,214: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">PhoneExtension</h3> | ||
:Returns the parsed extension for the phone number entered in the Phone field. | :Returns the parsed extension for the phone number entered in the Phone field. | ||
Line 771: | Line 2,226: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">PhoneNumber</h3> | ||
:Returns the standardized phone number for the record. | :Returns the standardized phone number for the record. | ||
Line 783: | Line 2,238: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">PhonePrefix</h3> | ||
:Returns the parsed prefix for the phone number entered in the Phone field. | :Returns the parsed prefix for the phone number entered in the Phone field. | ||
Line 795: | Line 2,250: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">PhoneSuffix</h3> | ||
:Returns the parsed suffix for the phone number entered in the Phone field. | :Returns the parsed suffix for the phone number entered in the Phone field. | ||
Line 807: | Line 2,262: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">PlaceCode</h3> | ||
:When ZIP codes overlap, the City field will always return the city that covers most of the ZIP area. If the address is located outside of that city but within the ZIP Code, Place Code will refer to that area. | :When ZIP codes overlap, the City field will always return the city that covers most of the ZIP area. If the address is located outside of that city but within the ZIP Code, Place Code will refer to that area. | ||
Line 819: | Line 2,274: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">PlaceName</h3> | ||
:When ZIP codes overlap, the City field will always return the city that covers most of the ZIP area. If the address is located outside of that city but within the ZIP Code, Place Name will refer to that area. | :When ZIP codes overlap, the City field will always return the city that covers most of the ZIP area. If the address is located outside of that city but within the ZIP Code, Place Name will refer to that area. | ||
Line 831: | Line 2,286: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">Plus4</h3> | ||
:Returns the 4-digit plus4 for the input address. If this column is requested, the PostalCode field will only contain the 5-digit ZIP for U.S. addresses. | :Returns the 4-digit plus4 for the input address. If this column is requested, the PostalCode field will only contain the 5-digit ZIP for U.S. addresses. | ||
Line 843: | Line 2,298: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">PoliticalParty*</h3> | ||
:Returns an individual’s political affiliation. | |||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01" | |||
!Value | |||
|- | |||
|Blank | |||
|- | |||
|No Party | |||
|- | |||
|Republican | |||
|- | |||
|Democrat | |||
|- | |||
|Independent | |||
|} | |||
:{| class="alternate01" | :{| class="alternate01" | ||
Line 855: | Line 2,326: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">PostalCode</h3> | ||
:Returns the 9-digit postal code for U.S. addresses and 6-digit postal code for Canadian addresses. | :Returns the 9-digit postal code for U.S. addresses and 6-digit postal code for Canadian addresses. | ||
Line 867: | Line 2,338: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">PresenceOfChildren*</h3> | ||
:Returns the presence of children in the household. | :Returns the presence of children in the household. | ||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01" | :{| class="alternate01" | ||
Line 879: | Line 2,352: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">PresenceOfSenior*</h3> | ||
:Returns the presence of | :Returns the presence of senior/s in the household that are 55 and above. | ||
:<nowiki>*</nowiki>Will not return for credit licenses and will instead return a GE29 error code. | |||
:{| class="alternate01" | |||
!Value | |||
|- | |||
|Blank | |||
|- | |||
|Yes | |||
|- | |||
|No | |||
|} | |||
:{| class="alternate01" | :{| class="alternate01" | ||
Line 891: | Line 2,376: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">PrivateMailBox</h3> | ||
:Returns the private mail box number for the address in the AddressLine field, if any. Private mailboxes are private mail boxes in commercial mail receiving agencies, like a UPS Store. If requested, the Private mailbox will be populated in this field instead of the Address field. | :Returns the private mail box number for the address in the AddressLine field, if any. Private mailboxes are private mail boxes in commercial mail receiving agencies, like a UPS Store. If requested, the Private mailbox will be populated in this field instead of the Address field. | ||
Line 903: | Line 2,388: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">RecordID</h3> | ||
:This is a string value that is a unique identifier for the current record if one was sent in the request. Use this element to match a request record and the corresponding response record. | :This is a string value that is a unique identifier for the current record if one was sent in the request. Use this element to match a request record and the corresponding response record. | ||
Line 924: | Line 2,397: | ||
|- | |- | ||
|SOAP/XML||<code><RecordID>'''''string'''''</RecordID></code> | |SOAP/XML||<code><RecordID>'''''string'''''</RecordID></code> | ||
|} | |} | ||
Line 942: | Line 2,403: | ||
: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|Personator Result Codes]]. | :For a complete list of codes, see [[Result Code Details#Personator Consumer|Personator Consumer Result Codes]]. | ||
:{| class="alternate01" | :{| class="alternate01" | ||
Line 961: | Line 2,422: | ||
|JSON||<code>"Salutation":"'''''string'''''"</code> | |JSON||<code>"Salutation":"'''''string'''''"</code> | ||
|- | |- | ||
|SOAP/XML||<code><Salutation>'''''string'''''</> | |SOAP/XML||<code><Salutation>'''''string'''''</Salutation></code> | ||
|} | |} | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">SecondarySchoolDistrictCode</h3> | ||
:Returns a 5 digit string representing the Secondary School District Code for the requested record. | :Returns a 5 digit string representing the Secondary School District Code for the requested record. | ||
Line 977: | Line 2,438: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">SecondarySchoolDistrictName</h3> | ||
:Returns the Secondary School District Name for the requested record. | :Returns the Secondary School District Name for the requested record. | ||
Line 1,001: | Line 2,462: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">StateDistrictLower</h3> | ||
:Returns a 3 digit string representing the Lower State District Code for the requested record. | :Returns a 3 digit string representing the Lower State District Code for the requested record. | ||
Line 1,013: | Line 2,474: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">StateDistrictUpper</h3> | ||
:Returns a 3 digit string representing the Upper State District Code for the requested record. | :Returns a 3 digit string representing the Upper State District Code for the requested record. | ||
Line 1,025: | Line 2,486: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">StateName</h3> | ||
:Returns the full name of the state entered in the State field. | :Returns the full name of the state entered in the State field. | ||
Line 1,049: | Line 2,510: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">TopLevelDomain</h3> | ||
:Returns the parsed top-level domain name for the email entered in the Email field. | :Returns the parsed top-level domain name for the email entered in the Email field. | ||
Line 1,058: | Line 2,519: | ||
|- | |- | ||
|SOAP/XML||<code><TopLevelDomain>'''''string'''''</TopLevelDomain></code> | |SOAP/XML||<code><TopLevelDomain>'''''string'''''</TopLevelDomain></code> | ||
|} | |} | ||
Line 1,085: | Line 2,534: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">UnifiedSchoolDistrictCode</h3> | ||
:Returns a 5 digit string representing the Unified School District Code for the requested record. | :Returns a 5 digit string representing the Unified School District Code for the requested record. | ||
Line 1,097: | Line 2,546: | ||
<h3 style="background-color:rgb(240,240,240);"> | <h3 style="background-color:rgb(240,240,240);">UnifiedSchoolDistrictName</h3> | ||
:Returns the Secondary Unified District Name for the requested record. | :Returns the Secondary Unified District Name for the requested record. | ||
Line 1,119: | Line 2,568: | ||
|SOAP/XML||<code><UrbanizationName>'''''string'''''</UrbanizationName></code> | |SOAP/XML||<code><UrbanizationName>'''''string'''''</UrbanizationName></code> | ||
|} | |} | ||
[[Category:Personator]] | [[Category:Personator]] |
Latest revision as of 18:02, 8 November 2024
Personator Consumer Navigation | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
| ||||||||
| ||||||||
| ||||||||
Sample Code |
A response is the result of a request. This consists of returned results codes, parsed address elements, and appended address information.
Depending on the protocol used to make the request, the response will be in a certain protocol. Personator supports the JSON, JSONP, SOAP, and XML protocols.
Field Names
This is a list of the response field names and their protocol naming conventions. Fields with an asterisk (*) are not available with a credits license and will return a GE29 error code if attempted.
Field Name | Level | JSON/XML |
---|---|---|
Version | Response | Version |
TransmissionReference | TransmissionReference | |
TransmissionResults | TransmissionResults | |
TotalRecords | TotalRecords | |
AddressDeliveryInstallation | Record | AddressDeliveryInstallation |
AddressExtras | AddressExtras | |
AddressHouseNumber | AddressHouseNumber | |
AddressKey | AddressKey | |
AddressLine1 | AddressLine1 | |
AddressLine2 | AddressLine2 | |
AddressLockBox | AddressLockBox | |
AddressPostDirection | AddressPostDirection | |
AddressPreDirection | AddressPreDirection | |
AddressPrivateMailboxName | AddressPrivateMailboxName | |
AddressPrivateMailboxRange | AddressPrivateMailboxRange | |
AddressRouteService | AddressRouteService | |
AddressStreetName | AddressStreetName | |
AddressStreetSuffix | AddressStreetSuffix | |
AddressSuiteName | AddressSuiteName | |
AddressSuiteNumber | AddressSuiteNumber | |
AddressTypeCode | AddressTypeCode | |
AreaCode | AreaCode | |
CBSACode | CBSACode | |
CBSADivisionCode | CBSADivisionCode | |
CBSADivisionLevel | CBSADivisionLevel | |
CBSADivisionTitle | CBSADivisionTitle | |
CBSALevel | CBSALevel | |
CBSATitle | CBSATitle | |
CarrierRoute | CarrierRoute | |
CensusBlock | CensusBlock | |
CensusKey | CensusKey | |
CensusTract | CensusTract | |
ChildrenAgeRange* | ChildrenAgeRange | |
City | City | |
CityAbbreviation | CityAbbreviation | |
CompanyName | CompanyName | |
CongressionalDistrict | CongressionalDistrict | |
CountryCode | CountryCode | |
CountryName | CountryName | |
CountyFIPS | CountyFIPS | |
CountyName | CountyName | |
CountySubdivisionCode | CountySubdivisionCode | |
CountySubdivisionName | CountySubdivisionName | |
CreditCardUser* | CreditCardUser | |
DateLastConfirmed | DateLastConfirmed | |
DateOfBirth* | DateOfBirth | |
DateOfDeath* | DateOfDeath | |
DeliveryIndicator | DeliveryIndicator | |
DeliveryPointCheckDigit | DeliveryPointCheckDigit | |
DeliveryPointCode | DeliveryPointCode | |
DemographicsGender* | DemographicsGender | |
DemographicsResults | DemographicsResults | |
DistanceAddressToIP | DistanceAddressToIP | |
DomainName | DomainName | |
Education* | Education | |
ElementarySchoolDistrictCode | ElementarySchoolDistrictCode | |
ElementarySchoolDistrictName | ElementarySchoolDistrictName | |
EmailAddress | EmailAddress | |
EstimatedHomeValue* | EstimatedHomeValue | |
EthnicCode* | EthnicCode | |
EthnicGroup* | EthnicGroup | |
Gender | Gender | |
Gender2 | Gender2 | |
HouseholdIncome* | HouseholdIncome | |
HouseholdSize* | HouseholdSize | |
IPAddress | IPAddress | |
IPCity | IPCity | |
IPConnectionSpeed | IPConnectionSpeed | |
IPConnectionType | IPConnectionType | |
IPContinent | IPContinent | |
IPCountryAbbreviation | IPCountryAbbreviation | |
IPCountryName | IPCountryName | |
IPDomainName | IPDomainName | |
IPISPName | IPISPName | |
IPLatitude | IPLatitude | |
IPLongitude | IPLongitude | |
IPPostalCode | IPPostalCode | |
IPProxyDescription | IPProxyDescription | |
IPProxyType | IPProxyType | |
IPRegion | IPRegion | |
IPUTC | IPUTC | |
Latitude | Latitude | |
LengthOfResidence* | LengthOfResidence | |
Longitude | Longitude | |
MailboxName | MailboxName | |
MaritalStatus* | MaritalStatus | |
MelissaAddressKey | MelissaAddressKey | |
MelissaAddressKeyBase | MelissaAddressKeyBase | |
MelissaIdentityKey | MelissaIdentityKey | |
MoveDate | MoveDate | |
NameFirst | NameFirst | |
NameFirst2 | NameFirst2 | |
NameFull | NameFull | |
NameLast | NameLast | |
NameLast2 | NameLast2 | |
NameMiddle | NameMiddle | |
NameMiddle2 | NameMiddle2 | |
NamePrefix | NamePrefix | |
NamePrefix2 | NamePrefix2 | |
NameSuffix | NameSuffix | |
NameSuffix2 | NameSuffix2 | |
NewAreaCode | NewAreaCode | |
Occupation* | Occupation | |
OwnRent* | OwnRent | |
PhoneCountryCode | PhoneCountryCode | |
PhoneCountryName | PhoneCountryName | |
PhoneExtension | PhoneExtension | |
PhoneNumber | PhoneNumber | |
PhonePrefix | PhonePrefix | |
PhoneSuffix | PhoneSuffix | |
PlaceCode | PlaceCode | |
PlaceName | PlaceName | |
Plus4 | Plus4 | |
PoliticalParty* | PoliticalParty | |
PostalCode | PostalCode | |
PresenceOfChildren* | PresenceOfChildren | |
PresenceOfSenior* | PresenceOfSenior | |
PrivateMailBox | PrivateMailBox | |
RecordID | RecordID | |
Results | Results | |
Salutation | Salutation | |
SecondarySchoolDistrictCode | SecondarySchoolDistrictCode | |
SecondarySchoolDistrictName | SecondarySchoolDistrictName | |
State | State | |
StateDistrictLower | StateDistrictLower | |
StateDistrictUpper | StateDistrictUpper | |
StateName | StateName | |
Suite | Suite | |
TopLevelDomain | TopLevelDomain | |
UTC | UTC | |
UnifiedSchoolDistrictCode | UnifiedSchoolDistrictCode | |
UnifiedSchoolDistrictName | UnifiedSchoolDistrictName | |
UrbanizationName | UrbanizationName |
Response Elements
The following elements are the basic options for each request. These apply to the entire response, not the individual records.
Version
- This is a string value that is the current revision number of Personator.
Protocol Syntax JSON "Version":"string"
SOAP/XML <Version>string</Version>
TransmissionReference
- This is a string value that serves as a unique identifier for this set of records. It is returned as sent by the Request Array, allowing you to match the Response to the Request.
Protocol Syntax JSON "TransmissionReference":"string"
SOAP/XML <TransmissionReference>string</TransmissionReference>
TransmissionResults
- 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 Consumer Result Codes.
Protocol Syntax JSON "TransmissionResults":"string"
SOAP/XML <TransmissionResults>string</TransmissionResults>
TotalRecords
- Displays the total number of records returned.
Protocol Syntax JSON "TotalRecords":"string"
SOAP/XML <TotalRecords>string</TotalRecords>
Response Record Elements
JSON will only contain the Records element.
Protocol Definition JSON Each record will be contained within [{}] under the Records element. SOAP XML
Each of the following elements are returned for each record in the Response Array.
AddressDeliveryInstallation
- Canada Only.
- Returns the parsed delivery installation for the address entered in the AddressLine field.
Protocol Syntax JSON "AddressDeliveryInstallation":"string"
SOAP/XML <AddressDeliveryInstallation>string</AddressDeliveryInstallation>
AddressExtras
- Any extra information that does not fit in the AddressLine fields.
Protocol Syntax JSON "AddressExtras":"string"
SOAP/XML <AddressExtras>string</AddressExtras>
AddressHouseNumber
- Returns the parsed house number for the address entered in the AddressLine field.
Protocol Syntax JSON "AddressHouseNumber":"string"
SOAP/XML <AddressHouseNumber>string</AddressHouseNumber>
AddressKey
- Returns a unique identifier for an address. This key can be used with other current and future Melissa services.
Protocol Syntax JSON "AddressKey":"string"
SOAP/XML <AddressKey>string</AddressKey>
AddressLine1
- Returns the address entered in the AddressLine field. If two addresses were entered and only one is valid, the valid address is returned instead. This includes the suite and private mailbox.
Protocol Syntax JSON "AddressLine1":"string"
SOAP/XML <AddressLine1>string</AddressLine1>
AddressLine2
- If two addresses are passed into the AddressLine field, the second address is returned here. If only one of two addresses is valid, the valid address will be returned in Address Line 1.
Protocol Syntax JSON "AddressLine2":"string"
SOAP/XML <AddressLine2>string</AddressLine2>
AddressLockBox
- Canada Only.
- Returns the parsed lock box number for the address entered in the AddressLine field.
Protocol Syntax JSON "AddressLockBox":"string"
SOAP/XML <AddressLockBox>string</AddressLockBox>
AddressPostDirection
- Returns the parsed post-direction for the address entered in the AddressLine field.
Protocol Syntax JSON "AddressPostDirection":"string"
SOAP/XML <AddressPostDirection>string</AddressPostDirection>
AddressPreDirection
- Returns the parsed pre-direction for the address entered in the AddressLine field.
Protocol Syntax JSON "AddressPreDirection":"string"
SOAP/XML <AddressPreDirection>string</AddressPreDirection>
AddressPrivateMailboxName
- Returns the parsed private mailbox name for the address entered in the AddressLine field.
Protocol Syntax JSON "AddressPrivateMailboxName":"string"
SOAP/XML <AddressPrivateMailboxName>string</AddressPrivateMailboxName>
AddressPrivateMailboxRange
- Returns the parsed private mailbox range for the address entered in the AddressLine field.
Protocol Syntax JSON "AddressPrivateMailboxRange":"string"
SOAP/XML <AddressPrivateMailboxRange>string</AddressPrivateMailboxRange>
AddressRouteService
- Canada Only.
- Returns the parsed route service number for the address entered in the AddressLine field.
Protocol Syntax JSON "AddressRouteService":"string"
SOAP/XML <AddressRouteService>string</AddressRouteService>
AddressStreetName
- Returns the parsed street name for the address entered in the AddressLine field.
Protocol Syntax JSON "AddressStreetName":"string"
SOAP/XML <AddressStreetName>string</AddressStreetName>
AddressStreetSuffix
- Returns the parsed street suffix for the address entered in the AddressLine field.
Protocol Syntax JSON "AddressStreetSuffix":"string"
SOAP/XML <AddressStreetSuffix>string</AddressStreetSuffix>
AddressSuiteName
- Returns the parsed suite name for the address entered in the AddressLine field.
Protocol Syntax JSON "AddressSuiteName":"string"
SOAP/XML <AddressSuiteName>string</AddressSuiteName>
AddressSuiteNumber
- Returns the parsed suite number for the address entered in the AddressLine field.
Protocol Syntax JSON "AddressSuiteNumber":"string"
SOAP/XML <AddressSuiteNumber>string</AddressSuiteNumber>
AddressTypeCode
- Returns a code for the address type in the AddressLine field. Please see the Result Code Details for the list of possible codes.
Protocol Syntax JSON "AddressTypeCode":"string"
SOAP/XML <AddressTypeCode>string</AddressTypeCode>
AreaCode
- Returns the parsed area code for the phone number entered in the Phone field.
Protocol Syntax JSON "AreaCode":"string"
SOAP/XML <AreaCode>string</AreaCode>
CBSACode
- Census Bureau’s Core Based Statistical Area (CBSA). Returns the 5-digit code for the CBSA associated with the requested record.
Protocol Syntax JSON "CBSACode":"string"
SOAP/XML <CBSACode>string</CBSACode>
CBSADivisionCode
- Returns the code for a division associated with the requested record, if any.
Protocol Syntax JSON "CBSADivisionCode":"string"
SOAP/XML <CBSADivisionCode>string</CBSADivisionCode>
CBSADivisionLevel
- Returns whether the CBSA division, if any, is metropolitan or micropolitan.
Protocol Syntax JSON "CBSADivisionLevel":"string"
SOAP/XML <CBSADivisionLevel>string</CBSADivisionLevel>
CBSADivisionTitle
- Returns the title for the CBSA division, if any.
Protocol Syntax JSON "CBSADivisionTitle":"string"
SOAP/XML <CBSADivisionTitle>string</CBSADivisionTitle>
CBSALevel
- Returns whether the CBSA is metropolitan or micropolitan.
Protocol Syntax JSON "CBSALevel":"string"
SOAP/XML <CBSALevel>string</CBSALevel>
CBSATitle
- Returns the title for the CBSA.
Protocol Syntax JSON "CBSATitle":"string"
SOAP/XML <CBSATitle>string</CBSATitle>
CarrierRoute
- Returns a 4-character code defining the carrier route for this record.
Protocol Syntax JSON "CarrierRoute":"string"
SOAP/XML <CarrierRoute>string</CarrierRoute>
CensusBlock
- Returns a 4-digit string containing the census block number associated with the requested record.
Protocol Syntax JSON "CensusBlock":"string"
SOAP/XML <CensusBlock>string</CensusBlock>
CensusKey
- Returns a 15 digit string containing the concatenated County FIPS, Census Tract and Census Block.
Protocol Syntax JSON "CensusKey":"string"
SOAP/XML <CensusKey>string</CensusKey>
CensusTract
- Returns a 4-to 6-digit string containing the census tract number associated with the requested record.
- Census tracts are small subdivisions of a county.
Protocol Syntax JSON "CensusTract":"string"
SOAP/XML <CensusTract>string</CensusTract>
ChildrenAgeRange*
- Returns the age range of children present in the household.
- *Will not return for credit licenses and will instead return a GE29 error code.
Value Blank 0-2 3-5 6-10 11-15 16-17
Protocol Syntax JSON "ChildrenAgeRange":"string"
SOAP/XML <ChildrenAgeRange>string</ChildrenAgeRange>
City
- Returns the city entered in the City field.
Protocol Syntax JSON "City":"string"
SOAP/XML <City>string</City>
CityAbbreviation
- Returns an abbreviation for the city entered in the City field, if any.
Protocol Syntax JSON "CityAbbreviation":"string"
SOAP/XML <CityAbbreviation>string</CityAbbreviation>
CompanyName
- Returns the company name.
Protocol Syntax JSON "CompanyName":"string"
SOAP/XML <CompanyName>string</CompanyName>
CongressionalDistrict
- Returns the 2-digit congressional district that belongs to the requested record.
Protocol Syntax JSON "CongressionalDistrict":"string"
SOAP/XML <CongressionalDistrict>string</CongressionalDistrict>
CountryCode
- Returns the country code for the country in the Country field.
Protocol Syntax JSON "CountryCode":"string"
SOAP/XML <CountryCode>string</CountryCode>
CountryName
- Returns the country name for the record.
Protocol Syntax JSON "CountryName":"string"
SOAP/XML <CountryName>string</CountryName>
CountyFIPS
- Returns the FIPS code for the county in the County field.
Protocol Syntax JSON "CountyFIPS":"string"
SOAP/XML <CountyFIPS>string</CountyFIPS>
CountyName
- Returns the county name.
Protocol Syntax JSON "CountyName":"string"
SOAP/XML <CountyName>string</CountyName>
CountySubdivisionCode
- Returns a 5 digit string representing the County Subdivision Code for the requested record.
Protocol Syntax JSON "CountySubdivisionCode":"string"
SOAP/XML <CountySubdivisionCode>string</CountySubdivisionCode>
CountySubdivisionName
- Returns the County Subdivision Name for the requested record.
Protocol Syntax JSON "CountySubdivisionName":"string"
SOAP/XML <CountySubdivisionName>string</CountySubdivisionName>
CreditCardUser*
- Returns whether the user has a credit card or not.
- *Will not return for credit licenses and will instead return a GE29 error code.
Value Blank Yes No
Protocol Syntax JSON "CreditCardUser":"string"
SOAP/XML <CreditCardUser>string</CreditCardUser>
DateLastConfirmed
- Returns the date this record was last seen updated from one of Personator’s Data Sources.
Protocol Syntax JSON "DateLastConfirmed":"string"
SOAP/XML <DateLastConfirmed>string</DateLastConfirmed>
DateOfBirth*
- Returns the date of birth in the format YYYYMM. Accuracy is only to the month.
- *Will not return for credit licenses and will instead return a GE29 error code.
Protocol Syntax JSON "DateOfBirth":"string"
SOAP/XML <DateOfBirth>string</DateOfBirth>
DateOfDeath*
- Returns the full date of death in the format YYYYMMDD.
- *Will not return for credit licenses and will instead return a GE29 error code.
Protocol Syntax JSON "DateOfDeath":"string"
SOAP/XML <DateOfDeath>string</DateOfDeath>
DeliveryIndicator
- Returns an indicator of whether an address is a business address or residential address.
Value Definition R Residential B Business U Unknown
Protocol Syntax JSON "DeliveryIndicator":"string"
SOAP/XML <DeliveryIndicator>string</DeliveryIndicator>
DeliveryPointCheckDigit
- Returns a string value containing the 1-digit delivery point check digit.
Protocol Syntax JSON "DeliveryPointCheckDigit":"string"
SOAP/XML <DeliveryPointCheckDigit>string</DeliveryPointCheckDigit>
DeliveryPointCode
- Returns a string value containing the 2-digit delivery point code.
Protocol Syntax JSON "DeliveryPointCode":"string"
SOAP/XML <DeliveryPointCode>string</DeliveryPointCode>
DemographicsGender*
- Returns gender based on demographics data.
- *Will not return for credit licenses and will instead return a GE29 error code.
Value Unknown Male Female Neutral
Protocol Syntax JSON "DemographicsGender":"string"
SOAP/XML <DemographicsGender>string</DemographicsGender>
DemographicsResults
- If any demographics are enabled, Demographics Results will return a comma delimited string containing all the results of the demographics combined.
Protocol Syntax JSON "DemographicsResults":"string"
SOAP/XML <DemographicsResults>string</DemographicsResults>
DistanceAddressToIP
- This is the distance in miles between the latitude and longitude of the physical location of the IP Addressn and the latitude and longitude of the input Address.
Protocol Syntax JSON "DistanceAddressToIP":"string"
SOAP/XML <DistanceAddressToIP>string</DistanceAddressToIP>
DomainName
- Returns the parsed domain name for the email entered in the Email field.
Protocol Syntax JSON "DomainName":"string"
SOAP/XML <DomainName>string</DomainName>
Education*
- Returns the highest level of education completed by an individual.
- *Will not return for credit licenses and will instead return a GE29 error code.
Value Blank High School College Graduate School Vocational/Technical School
Protocol Syntax JSON "Education":"string"
SOAP/XML <Education>string</Education>
ElementarySchoolDistrictCode
- Returns a 5 digit string representing the Elementary School District Code for the requested record.
Protocol Syntax JSON "ElementarySchoolDistrictCode":"string"
SOAP/XML <ElementarySchoolDistrictCode>string</ElementarySchoolDistrictCode>
ElementarySchoolDistrictName
- Returns the Elementary School District Name for the requested record.
Protocol Syntax JSON "ElementarySchoolDistrictName":"string"
SOAP/XML <ElementarySchoolDistrictName>string</ElementarySchoolDistrictName>
EmailAddress
- Returns the email address entered in the Email field.
Protocol Syntax JSON "EmailAddress":"string"
SOAP/XML <EmailAddress>string</EmailAddress>
EstimatedHomeValue*
- The estimated value of the home, given in U.S. Dollars.
- *Will not return for credit licenses and will instead return a GE29 error code.
Protocol Syntax JSON "EstimatedHomeValue":"string"
SOAP/XML <EstimatedHomeValue>string</EstimatedHomeValue>
EthnicCode*
- Returns an individual’s specific ethnicity.
- *Will not return for credit licenses and will instead return a GE29 error code.
Value Afghan African-American Albanian Aleutian Algerian American Indian Arabian Armenian Ashanti Australian Austrian Azerbaijani Bahrain Bangladesh Basotho Basque Belgian Belorussian Beninese Bhutanese Black African Bosnian Muslim Botswanian Bulgarian Burkina Faso Burundian Cameroonian Caribbean African American Central African Republic Chadian Chechnyan Chinese Comoros Congolese Croatian Czech Danish Djiboutian Dutch Egyptian English Equatorial Guinea Estonian Ethiopian Fiji Finnish French Gabon Gambian Georgian German Ghanaian Greek Guinea Bissau Guinean Guyanese Hausa Hawaiian Icelandic Indian Indonesian Iraqi Irish Italian Ivorian Japanese Jewish Kampuchean/Khmer(Cambodian) Kazakhstan Kenyan Kirghizia Korean Kurdish Kuwaiti Kyrgyzstani Laotian Latvian Lesotho Liberian Libyan Liechtenstein Lithuanian Luxembourgian Macedonia Madagascan Malawian Malaysian Maldivian & Tongan Malian Maltese Manx Mauritanian Moldovan Mongolian Moroccan Mozambican Multi-Ethnic Myanmar (Burmese) Namibian Nepalese New Zealand Niger Nigerian Norwegian Other Oriental Pakistani Papua New Guinean Persian Philippine Pili Polish Portuguese Qatari Romanian Russian Saudi Scottish Senegalese Serbian Seychelles Sierre Leone Sinhalese (Sri-Lankan) Slovakian Slovenian Somalian South African Spanish Sudanese Surinamese Swedish Swiss Syrian Tajik Tajikistan Tanzanian Telugan Thai Tibetan Togolese Tonga Tunisian Turkish Turkmenistan Ugandan Ukrainian Uzbekistan Vanuatuan Vietnamese Welsh Western Samoan Xhosa Yemeni Zairean Zambian Zimbabwean Zulu
Protocol Syntax JSON "EthnicCode":"string"
SOAP/XML <EthnicCode>string</EthnicCode>
EthnicGroup*
- Returns the grouped category for a person’s ethnicity. This is a more generalized grouping compared to Ethnic Codes.
- *Will not return for credit licenses and will instead return a GE29 error code.
Value Southeast Asian Central & Southwest Asian Eastern European All African American Ethnic Groups Middle Eastern Jewish Mediterranean Native American Far Eastern Polynesian Scandinavian Other Western European Hispanic
Protocol Syntax JSON "EthnicGroup":"string"
SOAP/XML <EthnicGroup>string</EthnicGroup>
Gender
- Returns a gender for the name in the FullName field.
Protocol Syntax JSON "Gender":"string"
SOAP/XML <Gender>string</Gender>
Gender2
- Only used if 2 names are in the FullName field. Returns a gender for the second name in the FullName field.
Protocol Syntax JSON "Gender2":"string"
SOAP/XML <Gender2>string</Gender2>
HouseholdIncome*
- Returns the range of the income of the returned individual for the household.
- *Will not return for credit licenses and will instead return a GE29 error code.
Protocol Syntax JSON "HouseholdIncome":"string"
SOAP/XML <HouseholdIncome>string</HouseholdIncome>
HouseholdSize*
- Returns the number of occupants in the household.
- *Will not return for credit licenses and will instead return a GE29 error code.
Value Blank 1 2 3 4 5 6 7 8 9
Protocol Syntax JSON "HouseholdSize":"string"
SOAP/XML <HouseholdSize>string</HouseholdSize>
IPAddress
- The IP address being looked up.
Protocol Syntax JSON "IPAddress":"string"
SOAP/XML <IPAddress>string</IPAddress>
IPCity
- The city where the IP address is located.
Protocol Syntax JSON "IPCity":"string"
SOAP/XML <IPCity>string</IPCity>
IPConnectionSpeed
- The connection speed associated with this IP address.
Value dialup broadband ultra broadband
Protocol Syntax JSON "IPConnectionSpeed":"string"
SOAP/XML <IPConnectionSpeed>string</IPConnectionSpeed>
IPConnectionType
- The type of connection used by this IP address.
Value dialup wired wifi mobile satellite
Protocol Syntax JSON "IPConnectionType":"string"
SOAP/XML <IPConnectionType>string</IPConnectionType>
IPContinent
- The continent where the IP address is located.
Protocol Syntax JSON "IPContinent":"string"
SOAP/XML <IPContinent>string</IPContinent>
IPCountryAbbreviation
- The ISO 3166-1 alpha-2 country code of the country where the IP address is located.
Protocol Syntax JSON "IPCountryAbbreviation":"string"
SOAP/XML <IPCountryAbbreviation>string</IPCountryAbbreviation>
IPCountryName
- The full name of the country where the IP address is located.
Protocol Syntax JSON "IPCountryName":"string"
SOAP/XML <IPCountryName>string</IPCountryName>
IPDomainName
- The domain name associated with this IP address.
Protocol Syntax JSON "IPDomainName":"string"
SOAP/XML <IPDomainName>string</IPDomainName>
IPISPName
- The name of the Internet Service Provider associated with the IP Address.
Protocol Syntax JSON "IPISPName":"string"
SOAP/XML <IPISPName>string</IPISPName>
IPLatitude
- The latitude for the IP address. This usually points to the IP Address's postal code.
Protocol Syntax JSON "IPLatitude":"string"
SOAP/XML <IPLatitude>string</IPLatitude>
IPLongitude
- The longitude for the IP address. This usually points to the IP Address's postal code.
Protocol Syntax JSON "IPLongitude":"string"
SOAP/XML <IPLongitude>string</IPLongitude>
IPPostalCode
- The postal code where the IP Address is located.
Protocol Syntax JSON "IPPostalCode":"string"
SOAP/XML <IPPostalCode>string</IPPostalCode>
IPProxyDescription
- Additional Details for the Proxy Type returned.
Value Tor-exit Tor-relay AOL Cloud DNS VPN Web-Browser
Protocol Syntax JSON "IPProxyDescription":"string"
SOAP/XML <IPProxyDescription>string</IPProxyDescription>
IPProxyType
- The type of proxy for an IP Address.
Value Definition Anonymous The IP address is a proxy and the actual IP address of the end user is not available. Transparent The IP address is a proxy, but the originating IP address of the end user can be detected by inspecting the HTTP headers, however, this can easily be spoofed Hosting The IP address belongs to a hosting facility or cloud provider and may be used as a proxy because an end user is not typically located in a hosting facility. These IP addresses may be rented per service agreement with the hosting facility and easily disposed. Corporate The IP address is registered to a specific location with end users sharing a single IP address. A typical example is of end users behind a router using Network Address Translation. Each user will appear to the world as coming from the same IP address Public The address is a known public proxy allowing multiple users to proxy their data from a location allowing public Internet access. Edu The IP address is from a known educational institution. AOL The IP address is an AOL proxy. Blank Not a known proxy.
Protocol Syntax JSON "IPProxyType":"string"
SOAP/XML <IPProxyType>string</IPProxyType>
IPRegion
- The region where the IP address is located, specific meaning varies from country to country. For IPs in the US this field returns the state that the IP is located within.
Protocol Syntax JSON "IPRegion":"string"
SOAP/XML <IPRegion>string</IPRegion>
IPUTC
- The GMT offset for the area where the IP address is located.
Protocol Syntax JSON "IPUTC":"string"
SOAP/XML <IPUTC>string</IPUTC>
Latitude
- Returns the geocoded latitude for the address entered in the AddressLine field.
Protocol Syntax JSON "Latitude":"string"
SOAP/XML <Latitude>string</Latitude>
LengthOfResidence*
- Returns the range of the individual's length of residency in their current address.
- *Will not return for credit licenses and will instead return a GE29 error code.
Value Less than 1 year 1-2 years 2-3 years 3-4 years 4-5 years 5-6 years 6-7 years 7-8 years 8-9 years 9-10 years 10-11 years 11-12 years 12-13 years 13-14 years 14-15 years 15+ years Unknown
Protocol Syntax JSON "LengthOfResidence":"string"
SOAP/XML <LengthOfResidence>string</LengthOfResidence>
Longitude
- Returns the geocoded longitude for the address entered in the AddressLine field.
Protocol Syntax JSON "Longitude":"string"
SOAP/XML <Longitude>string</Longitude>
MailboxName
- Returns the parsed mailbox name for the email entered in the Email field.
Protocol Syntax JSON "MailboxName":"string"
SOAP/XML <MailboxName>string</MailboxName>
MaritalStatus*
- Returns the individual's marital status.
- *Will not return for credit licenses and will instead return a GE29 error code.
Protocol Syntax JSON "MaritalStatus":"string"
SOAP/XML <MaritalStatus>string</MaritalStatus>
MelissaAddressKey
- Returns a unique key associated with an address.
Protocol Syntax JSON "MelissaAddressKey":"string"
SOAP/XML <MelissaAddressKey>string</MelissaAddressKey>
MelissaAddressKeyBase
- Returns a unique key associated with a building containing multiple suites/apartments.
Protocol Syntax JSON "MelissaAddressKeyBase":"string"
SOAP/XML <MelissaAddressKeyBase>string</MelissaAddressKeyBase>
MelissaIdentityKey
- Returns a unique key associated with an individual. In order to retrieve the MelissaIdentityKey, the Check and Verify Actions must both be enabled:
"Actions":"Check,Verify"
Protocol Syntax JSON "MelissaIdentityKey":"string"
SOAP/XML <MelissaIdentityKey>string</MelissaIdentityKey>
MoveDate
- Returns the date associated with the move address.
Protocol Syntax JSON "MoveDate":"string"
SOAP/XML <MoveDate>string</MoveDate>
NameFirst
- Returns the first name in the FullName field.
Protocol Syntax JSON "NameFirst":"string"
SOAP/XML <NameFirst>string</NameFirst>
NameFirst2
- Only used if 2 names are in the FullName field. Returns the second name in the FullName field.
Protocol Syntax JSON "NameFirst2":"string"
SOAP/XML <NameFirst2>string</NameFirst2>
NameFull
- Returns the full name for the record.
Protocol Syntax JSON "NameFull":"string"
SOAP/XML <NameFull>string</NameFull>
NameLast
- Returns the last name in the FullName field.
Protocol Syntax JSON "NameLast":"string"
SOAP/XML <NameLast>string</NameLast>
NameLast2
- Only used if 2 names are in the FullName field. Returns a last name for the second name in the FullName field.
Protocol Syntax JSON "NameLast2":"string"
SOAP/XML <NameLast2>string</NameLast2>
NameMiddle
- Returns a middle name for the name in the FullName field.
Protocol Syntax JSON "NameMiddle":"string"
SOAP/XML <NameMiddle>string</NameMiddle>
NameMiddle2
- Only used if 2 names are in the FullName field. Returns a middle name for the second name in the FullName field.
Protocol Syntax JSON "NameMiddle2":"string"
SOAP/XML <NameMiddle2>string</NameMiddle2>
NamePrefix
- Returns a prefix for the name in the FullName field.
Protocol Syntax JSON "NamePrefix":"string"
SOAP/XML <NamePrefix>string</NamePrefix>
NamePrefix2
- Only used if 2 names are in the FullName field. Returns a prefix for the second name in the FullName field.
Protocol Syntax JSON "NamePrefix2":"string"
SOAP/XML <NamePrefix2>string</NamePrefix2>
NameSuffix
- Returns a suffix for the name in the FullName field.
Protocol Syntax JSON "NameSuffix":"string"
SOAP/XML <NameSuffix>string</NameSuffix>
NameSuffix2
- Only used if 2 names are in the FullName field. Returns a suffix for the second name in the FullName field.
Protocol Syntax JSON "NameSuffix2":"string"
SOAP/XML <NameSuffix2>string</NameSuffix2>
NewAreaCode
- Returns the parsed new area code for the phone number entered in the Phone field.
Protocol Syntax JSON "NewAreaCode":"string"
SOAP/XML <NewAreaCode>string</NewAreaCode>
Occupation*
- Returns the category for the individual's occupation.
- *Will not return for credit licenses and will instead return a GE29 error code.
Value Physician/Dentist Healthcare Lawyer/Judge Professional/Technical Management Teacher/Educator Sales/Marketing Clerical/Service Worker Tradesmen/Laborer Farmer Student Homemaker Retired Federal Employee Unknown Military Military Retired Other Business Owner Religious Self Employed Financial
Protocol Syntax JSON "Occupation":"string"
SOAP/XML <Occupation>string</Occupation>
OwnRent*
- Returns the individual's status as owner or renter of the property.
- *Will not return for credit licenses and will instead return a GE29 error code.
Value Unknown Definite Renter Inferred Renter Inferred Owner Definite Owner
Protocol Syntax JSON "OwnRent":"string"
SOAP/XML <OwnRent>string</OwnRent>
PhoneCountryCode
- Returns the 2 character country code for the phone number entered in the Phone field.
Protocol Syntax JSON "PhoneCountryCode":"string"
SOAP/XML <PhoneCountryCode>string</PhoneCountryCode>
PhoneCountryName
- Returns the full country name for the phone number entered in the Phone field.
Protocol Syntax JSON "PhoneCountryName":"string"
SOAP/XML <PhoneCountryName>string</PhoneCountryName>
PhoneExtension
- Returns the parsed extension for the phone number entered in the Phone field.
Protocol Syntax JSON "PhoneExtension":"string"
SOAP/XML <PhoneExtension>string</PhoneExtension>
PhoneNumber
- Returns the standardized phone number for the record.
Protocol Syntax JSON "PhoneNumber":"string"
SOAP/XML <PhoneNumber>string</PhoneNumber>
PhonePrefix
- Returns the parsed prefix for the phone number entered in the Phone field.
Protocol Syntax JSON "PhonePrefix":"string"
SOAP/XML <PhonePrefix>string</PhonePrefix>
PhoneSuffix
- Returns the parsed suffix for the phone number entered in the Phone field.
Protocol Syntax JSON "PhoneSuffix":"string"
SOAP/XML <PhoneSuffix>string</PhoneSuffix>
PlaceCode
- When ZIP codes overlap, the City field will always return the city that covers most of the ZIP area. If the address is located outside of that city but within the ZIP Code, Place Code will refer to that area.
Protocol Syntax JSON "PlaceCode":"string"
SOAP/XML <PlaceCode>string</PlaceCode>
PlaceName
- When ZIP codes overlap, the City field will always return the city that covers most of the ZIP area. If the address is located outside of that city but within the ZIP Code, Place Name will refer to that area.
Protocol Syntax JSON "PlaceName":"string"
SOAP/XML <PlaceName>string</PlaceName>
Plus4
- Returns the 4-digit plus4 for the input address. If this column is requested, the PostalCode field will only contain the 5-digit ZIP for U.S. addresses.
Protocol Syntax JSON "Plus4":"string"
SOAP/XML <Plus4>string</Plus4>
PoliticalParty*
- Returns an individual’s political affiliation.
- *Will not return for credit licenses and will instead return a GE29 error code.
Value Blank No Party Republican Democrat Independent
Protocol Syntax JSON "PoliticalParty":"string"
SOAP/XML <PoliticalParty>string</PoliticalParty>
PostalCode
- Returns the 9-digit postal code for U.S. addresses and 6-digit postal code for Canadian addresses.
Protocol Syntax JSON "PostalCode":"string"
SOAP/XML <PostalCode>string</PostalCode>
PresenceOfChildren*
- Returns the presence of children in the household.
- *Will not return for credit licenses and will instead return a GE29 error code.
Protocol Syntax JSON "PresenceOfChildren":"string"
SOAP/XML <PresenceOfChildren>string</PresenceOfChildren>
PresenceOfSenior*
- Returns the presence of senior/s in the household that are 55 and above.
- *Will not return for credit licenses and will instead return a GE29 error code.
Value Blank Yes No
Protocol Syntax JSON "PresenceOfSenior":"string"
SOAP/XML <PresenceOfSenior>string</PresenceOfSenior>
PrivateMailBox
- Returns the private mail box number for the address in the AddressLine field, if any. Private mailboxes are private mail boxes in commercial mail receiving agencies, like a UPS Store. If requested, the Private mailbox will be populated in this field instead of the Address field.
Protocol Syntax JSON "PrivateMailBox":"string"
SOAP/XML <PrivateMailBox>string</PrivateMailBox>
RecordID
- This is a string value that is a unique identifier for the current record if one was sent in the request. Use this element to match a request record and the corresponding response record.
Protocol Syntax JSON "RecordID":"string"
SOAP/XML <RecordID>string</RecordID>
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 Consumer Result Codes.
Protocol Syntax JSON "Results":"string"
SOAP/XML <Results>string</Results>
Salutation
- Returns a salutation for the name in the FullName field.
Protocol Syntax JSON "Salutation":"string"
SOAP/XML <Salutation>string</Salutation>
SecondarySchoolDistrictCode
- Returns a 5 digit string representing the Secondary School District Code for the requested record.
Protocol Syntax JSON "SecondarySchoolDistrictCode":"string"
SOAP/XML <SecondarySchoolDistrictCode>string</SecondarySchoolDistrictCode>
SecondarySchoolDistrictName
- Returns the Secondary School District Name for the requested record.
Protocol Syntax JSON "SecondarySchoolDistrictName":"string"
SOAP/XML <SecondarySchoolDistrictName>string</SecondarySchoolDistrictName>
State
- Returns the state for the record.
Protocol Syntax JSON "State":"string"
SOAP/XML <State>string</State>
StateDistrictLower
- Returns a 3 digit string representing the Lower State District Code for the requested record.
Protocol Syntax JSON "StateDistrictLower":"string"
SOAP/XML <StateDistrictLower>string</StateDistrictLower>
StateDistrictUpper
- Returns a 3 digit string representing the Upper State District Code for the requested record.
Protocol Syntax JSON "StateDistrictUpper":"string"
SOAP/XML <StateDistrictUpper>string</StateDistrictUpper>
StateName
- Returns the full name of the state entered in the State field.
Protocol Syntax JSON "StateName":"string"
SOAP/XML <StateName>string</StateName>
Suite
- Returns the suite for the address in the AddressLine field, if any. If requested, the suite will be populated in this field instead of the Address field.
Protocol Syntax JSON "Suite":"string"
SOAP/XML <Suite>string</Suite>
TopLevelDomain
- Returns the parsed top-level domain name for the email entered in the Email field.
Protocol Syntax JSON "TopLevelDomain":"string"
SOAP/XML <TopLevelDomain>string</TopLevelDomain>
UTC
- Returns the time zone of the requested record. All Melissa Data products express time zones in UTC (Coordinated Universal Time).
Protocol Syntax JSON "UTC":"string"
SOAP/XML <UTC>string</UTC>
UnifiedSchoolDistrictCode
- Returns a 5 digit string representing the Unified School District Code for the requested record.
Protocol Syntax JSON "UnifiedSchoolDistrictCode":"string"
SOAP/XML <UnifiedSchoolDistrictCode>string</UnifiedSchoolDistrictCode>
UnifiedSchoolDistrictName
- Returns the Secondary Unified District Name for the requested record.
Protocol Syntax JSON "UnifiedSchoolDistrictName":"string"
SOAP/XML <UnifiedSchoolDistrictName>string</UnifiedSchoolDistrictName>
UrbanizationName
- Returns the urbanization name for the address entered in the AddressLine field. Usually only used if the address is in Puerto Rico.
Protocol Syntax JSON "UrbanizationName":"string"
SOAP/XML <UrbanizationName>string</UrbanizationName>