Personator Consumer
Important Announcements
None
General Information
- Personator Consumer Wiki Page
- Personator Consumer FAQ
- Personator Consumer Result Codes
- Quick Start Guide
- Support contact information: tech@melissa.com or 1-800-MELISSA (1-800-635-4772)
Build History
8.4.0.1318
Released on: October 2024
Added
- New Age Input Filtering for Personator
- New ES08 Result Code for Email Addresses to detect group email addresses (ex: sales@, support@, or postmaster@)
Changed
- None
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
8.4.0.1310
Released on: September 2024
Added
- None
Changed
- Melissa Identity Key now only gets appended when the record is verified (VR01, VR02 or VR03)
- Melissa Demographics will not longer appear for historical records (VS01)
- Credit car user will not longer return unless the name and address is verified (VR01)
- Children Age Range now returng multiple values
Deprecated
- None
Removed
- None
Fixed
- Fixed an issue where Moves were incorrectly returning for some cases
- Fixed an issue where demographics and MIK was not appending when a new name is appended
Security
- None
8.4.0.1295
Released on: July 2024
Added
- Added new AliasMode Option to preserve aliases addresses or convert them to the USPS preferred street name.
Changed
- None
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
8.4.0.1289
Released on: June 2024
Added
- None
Changed
- None
Deprecated
- None
Removed
- None
Fixed
- Fixed an issue where doing a MAK search sometimes does not append an address.
- Fixed an issue where the Demographics Gender output was requiring a subscription to demographics. Demographics Gender now correctly returns a value with a Check subscription.
Security
- Removed "Server: Kestrel" from headers
8.4.0.1282
Released on: April 2024
Added
- Personator now correctly appends Name Suffixes and Middle Names from the Data.
Changed
- It is no longer possible for newly suppressed records to move.
- It is no longer possible to detect moves based only on the Address and First Name.
Deprecated
- None
Removed
- None
Fixed
- Fixed an issue where MIK was not appending when doing Append Action Only.
Security
- None
8.4.0.1269
Released on: March 2024
Added
- None
Changed
- Personator will no longer move individuals based only on First Name and Address.
Deprecated
- None
Removed
- None
Fixed
- The service now correctly returns GE24 when users request for Demographics and they are not subscribed
Security
- Service now using .NET Core 8
7.4.0.1267
Released on: February 2024
Added
- None
Changed
- Response Header changed from Server: Microsoft-IIS/10.0 to Server: Kestrel
Deprecated
- None
Removed
- None
Fixed
- Fixed an issue where record suppression sometimes does not work
Security
- None
7.4.0.1265
Released on: January 2024
Added
- None
Changed
- None
Deprecated
- None
Removed
- None
Fixed
- Fixed an issue where older SOAP Request Structures were not accepted by the service.
Security
- Cache-Control Response Header now set to: no-cache,no-store,must-revalidate,private.
- Removed from Response Header: X-AspNet-Version: 4.0.30319
7.4.0.1257
Released on: December 2023
Added
- None
Changed
- More optimization improvement for when doing Check,Verify Action to improve response times in certain cases
Deprecated
- None
Removed
- None
Fixed
- None
Security
- WSDL Support for HTTPS URLs put in place.
7.4.0.1252
Released on: December 2023
Added
- None
Changed
- Optimization improvement for when doing Check,Verify Action to improve response times in certain cases
Deprecated
- None
Removed
- None
Fixed
- Actions Input now correctly accepts semicolon delimiter
- Fixed an issue where some information in the internal logs were being put in the wrong column
Security
- Supports new system for ignoring problematic records that cause the web service to crashes
7.4.0.1235
Released on: December 2023
Added
- None
Changed
- Web Service code is now in .NET Core.
Deprecated
- None
Removed
- None
Fixed
- None
Security
- Several back-end Security updates to comply with industry standards for web service security.
5.6.17.0
Released on: November 2023
Added
- None
Changed
- MelissaIdentityKey now outputs only when the Name and Address are determined to be a full match in the data.
Deprecated
- None
Removed
- None
Fixed
- Fixed an issue where certain long strings inputted to Email crashes the service
- Fixed an issue where VR04 sometimes does not return for a matching address and phone number when the centricity is set to Phone.
Security
- None
5.6.13.0
Released on: June 2023
Added
- None
Changed
- None
Deprecated
- None
Removed
- None
Fixed
- Fixed an issue where VR04 result codes was missing when doing a phone centric append
- Fixed an issue where VR05 result codes was missing when doing an email centric append
Security
- None
5.6.11.0
Released on: March 2023
Added
- None
Changed
- Phones and Emails should now get appended when doing Address Only as input with Append action enabled.
Deprecated
- Web service no longer supports Social Security Verification and Reverse Appends.
Removed
- None
Fixed
- Fixed an issue where MIK Reverse Append does not return some of the demographic information.
- Fixed an issue where some demographics don't get appended when doing reverse Phone and Reverse Email appends.
- Fixed an issue where VR04 is being returned even when there is no phone in the output.
- Fixed an issue where VR05 is being returned even when there is no email in the output.
Security
- None
5.6.7.0
Released on: February 2023
Added
- None
Changed
- Added Logic to append Phones and Emails when VR02 or VR03 are returned. Currently it is only checking for VR01.
- MIK Input now only requires Check and Verify Subscription Levels (Previously required Append).
Deprecated
- None
Removed
- None
Fixed
- Fixed an issue where DateLAstConfirmed was not populating
- Fixed an issue where MIK was non populating
Security
- None
5.6.6.0
Released on: January 2023
Added
-
New MIK (MelissaIdentityKey) Input for doing reverse appends using the Melissa Identity Key.
-
Added back-end configuration to disable SSN verification/reverse appends, in preparation for the March 27 SSN End of Life. Article can be found here
Changed
MelissaIdentityKey
output to now only require Check/Verify level action (Previously required Append Action).
Deprecated
- None
Removed
- None
Fixed
- Option for Cassandra bypass now fully implemented
Security
- None
5.6.2.0
Formerly: 5.6.2.0 - November 2022
Released on: November 2022
Added
- Added new
MelissaIdentityKey
andDateLastConfirmed
columns. For more information please see: https://www.melissa.com/quickstart-guides/personator-november-2022-advisory
Changed
- None
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
5.4.5.5
Formerly: 5.4.5.5 - July 2022
Released on: July 2022
Added
- None
Changed
-
Personator now supports 2010 and 2020 decennial census data. Information on how to retrieve decennial census data can be found here: https://wiki.melissadata.com/index.php?title=Personator_Consumer:Request#DecennialCensusKey
-
The following demographics have been normalized to be centric and standardized at the household level to prevent conflict in information:
- Presence of Children
- Children Age Range
- Senior Present
- Household Size
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
5.2.38.2
Formerly: 5.2.38.0 - November 2021
Released on: November 2021
Added
- None
Changed
- Improved API's ability to:
- Append more accurate demographics and contact information
- Verify name-address-phone-email correlation to ensure full contact accuracy
- Perform Moves and provide the latest address for individuals
- Recompiled Personator's Reference data with the newly acquired data sources. This offers better and more comprehensive data.
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
5.2.38.1
Formerly: 5.2.38.0 - June 2021
Released on: June 2021
Added
- None
Changed
- Handle external API with Transport Layer Security (TLS) 1.2 Protocol
- When VR01 only in the result code, append Phone and Email in the results
- Remove all non-numeric characters in the SSN Input
-
SSN Search Improvements
-
Changes to SSN result codes:
- VR11 changed to - Full name and SSN match
- VS12 added - Last name and SSN match
-
The following SSN action=append changed applied for:
- If it's VS12 only, allow appends.
- If it's VS50 only, allow appends.
- If it's BOTH VS12 and VS50, do not append
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
5.2.37.0
Formerly: 5.2.37.0 - November 2020
Released on: November 2020
Added
- None
Changed
- Major Update
- Personator now only appends Phones and Emails when there is an exact individual match (result codes contain VR01 AND NOT VS12 AND NOT VS13)
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
5.2.36.0
Formerly: 5.2.36.0 - August 2020
Released on: August 2020
Added
- None
Changed
- Minor Update
- Personator will no longer perform the append action when AS02 is returned in the results. Appends will now only occur for AS01 and AS03 result codes
Deprecated
- None
Removed
- None
Fixed
- Fixed a bug where the service sometimes returns bad phone numbers that return a PE03.
- Fixed a bug where the service sometimes replaces a phone number with a new phone number from the Personator Database, despite setting the option to
Append:Blank
Security
- None
5.2.35.0
Formerly: 5.2.35.0 - July 2020
Released on: July 2020
Added
- None
Changed
- Minor Update
- All addresses retuning Delivery Indicator of "B" will no longer return Demographic information. This is because business sites should not be returning consumer information.
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
5.2.34.0
Formerly: 5.2.34.0 - May 2020
Released on: May 2020
Added
- None
Changed
-
Major Update
- New featrure: opt=DecennialCensusKey:
2010|off
This option toggles the census key output to return the static 2010 census key instead of the latest census key.
- New featrure: opt=DecennialCensusKey:
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
5.2.33.0
Formerly: 5.2.33.0 - May 2020
Released on: May 2020
Added
- None
Changed
- Minor Update
- The NS02 Result code has been deemed unnecessary and will no longer return in the web service result codes.
- The PS02 (7-digit coded) will no longer return it the web service result codes. Instead, phone numbers will now code to PS01 (10-digit verified).
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
5.2.32.0
Formerly: 5.2.32.0 - April 2020
Released on: April 2020
Added
- None
Changed
- Major Update
- Personator now only returns demographics when there is an exact individual match (result codes contain VR01 AND NOT VS12 AND NOT VS13)
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
5.2.29.0
Formerly: 5.2.29.0 - February 2020
Released on: February 2020
Added
- None
Changed
-
Major Update
- New Feature: Advanced Address Type
When Advanced Address Type is set to on (&opt=AdvancedAddressType:on), the service will return more detailed Address Types.
-
Minor Update
- Improvements to Canadian GeoCoding coverage and accuracy.
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
5.2.25.0
Formerly: 5.2.25.0 - December 2018
Released on: December 2018
Added
- None
Changed
-
Minor Update
- Further improvements done to the GeoCoding by using new input Parameters using the MAK as input to produce more accurate GeoCoding information
-
Fixed the address format for Private Mailboxes.
- Improved data to increase AV23 and AV24 coding
- Addresses with valid localities but invalid addresses will no longer code to AV22
-
Other internal changes to improve GeoCoding accuracy.
Deprecated
- None
Removed
- None
Fixed
- Fixed an issue where the pipes (“|”) would sometimes output as part of the Results.
Security
- None
5.2.20.0
Formerly: 5.2.20.0 - October 2018
Released on: October 2018
Added
- None
Changed
-
Minor Update
- Internal Re-work of Geocoding Engine to replace direct database access to using the GeoCoder API.
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
5.2.16.0
Formerly: 5.2.16.0 - August 2018
Released on: August 2018
Added
- None
Changed
-
Minor Update
-
Credit Licenses are now supported within Personator. A Credit License allows users to store pre-paid credits to their license in order to access the service. Credits can be purchased through the Melissa Credit Portal. Certain features are not accessible through Credit Only Licenses including:
- SSN Verification
- IP Address Verificaiton
- Demographics
-
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
5.2.14.0
Formerly: 5.2.14.0 - June 2018
Released on: June 2018
Added
- None
Changed
- None
Deprecated
- None
Removed
- None
Fixed
- Fixed an issue where bad Canadian Email Addresses were being appended. It should now follow the same logic as the US.
- Fixed an issue where the EmailAddress column sometimes disappears when asking for Demographics:MaskOnly or Demographics:ValueOnly
- Fixed an issue where CBSA sometimes did not output correctly.
Security
- None
5.2.5.0
Formerly: 5.2.5.0 - April 2018
Released on: April 2018
Added
- None
Changed
-
Minor Update
- Global IP now returns GE27 in the TransmissionResults when a user is not subscribed to Global IP.
- Name Centric was removed from CentricHint Cascading. Currently, when CentricHint is auto (default), Personator will check by ordering (SSN, Address, Phone, and Email) for CentricHint, until match in the data is found.
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
5.2.2.0
Formerly: 5.2.2.0 - March 2018
Released on: March 2018
Added
- None
Changed
-
Minor Update
- Added new output placeholder for EstimatedHomeValue. This does not currently return any values, and is reserved for future implementation.
<EstimatedHomeValue />
Deprecated
- None
Removed
- None
Fixed
- Fixed a bug where Personator was returning redundant Email Result Codes
Security
- None
5.2.1.0
Formerly: 5.2.1.0 - March 2018
Released on: March 2018
Added
- None
Changed
-
Minor Update
- Added Name Centric Hint. This can be set as part of the options:
&opt=CentricHint:Name
- Added BirthDay, BirthMonth and BirthYear inputs. Setting the Date of Birth allows for additional filtering in order to match on specific individuals. This can be set in the input like so:
&bday={BirthDay}&bmo={BirthMonth}&byr={BirthYear}
- Added new input for supporting IP Address
&ip={IpAddress}
- The following outputs were also added in support of IP Address Verification in Personator:
<IPAddress/>
<IPCity/>
<IPCountryAbbreviation/>
<IPCountryName/>
<IPConnectionSpeed/>
<IPConnectionType/>
<IPContinent/>
<IPDomainName/>
<IPISPName/>
<IPLatitude/>
<IPLongitude/>
<IPPostalCode/>
<IPProxyType/>
<IPProxyDescription/>
<IPRegion/>
<IPUTC/>
- The new columns may be retrieved individually or by calling the requesting for the GrpIPAddress in the columns input:
cols=GrpIPAddress
- Added Name Centric Hint. This can be set as part of the options:
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
5.1.5.0
Formerly: 5.1.5.0 - July 2017
Released on: July 2017
Added
- Added Functionality for SSN Verification
Changed
- None
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
3.3.2.0
Formerly: 3.3.2.0 - April 2015
Released on: April 2015
Added
- Added Functionality for Canadian Append, Verify, and Move.
- Added PhoneCountryName and PhoneCountryCode output.
Changed
- None
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
3.2.65.0
Formerly: 3.2.65.0 - March 2015
Released on: March 2015
Added
- Added MoveConfidence(Strict|Loose) Option.
Changed
- None
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
3.2.59.0
Formerly: 3.2.59.0 - November 2014
Released on: November 2014
Added
- Added Demographics as part of the output columns
- Added LongAddressFormat(off|on|auto) Option.
Changed
- None
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
3.2.52.0
Formerly: 3.2.52.0 - September 2014
Released on: September 2014
Added
- None
Changed
- New mdHints Functionality for optional Speed Improvements
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
3.2.32.2
Formerly: 3.2.32.0 - June 2014
Released on: June 2014
Added
- Added 10 Year NCOA Move Capability
Changed
- Data Update
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
3.2.32.1
Formerly: 3.2.32.0 - February 2014
Released on: February 2014
Added
- Added 10 Year NCOA Move Capability
Changed
- Free Form Input - Personator will now accept single line Input String and parse out the Address, Company, Name, Phone and Email Address. FreeForm Inputs can be both fielded and unfielded.
- Email Append - Personator now has the capability to append Email Addresses
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
3.2.14.0
Formerly: 3.2.14.0 - July 2013
Released on: July 2013
Added
- Added 10 Year NCOA Move Capability
Changed
- Move Update - The Personator Web Service now has the ability to return the current address for an individual or company. This can be done by enabling the action Move.
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
1.0.00.0
Formerly: 1.0.00.0 - November 2012
Released on: November 2012
Added
- None
Changed
- None
Deprecated
- None
Removed
- None
Fixed
- None
Security
- None
Past Announcements
Major Database Update - September 29, 2021
Notice details can be found here.