Result Codes - Personator Identity

Service Level Result Codes

Note

The Service Level result codes apply to the service as a whole.

Code	Short Description	Long Description
Transmission Service Error
SE01	Cloud Service Internal Error	The cloud service experienced an internal error.
General Transmission Error
GE01	Empty Request Structure	The SOAP, JSON, or XML request structure is empty. Not to be confused with the GE01 GeoCode result code.
GE02	Empty Request Record Structure	The SOAP, JSON, or XML request record structure is empty. Not to be confused with the GE02 GeoCode result code.
GE03	Records Per Request Exceeded	The counted records sent more than the number of records allowed per request.
GE04	Empty License Key	The License Key is empty.
GE05	Invalid License Key	The License Key is invalid.
GE06	Disabled License Key	The License Key is disabled.
GE07	Invalid Request	The SOAP, JSON, or XML request is invalid.
GE08	Product/Level Not Enabled	The License Key is invalid for this product or level.
GE09	Customer Does Not Exist	The Customer ID is not in our system.
GE10	Customer License Disabled	The encrypted license is on the ban list.
GE11	Customer Disabled	The Customer ID is disabled.
GE12	IP Blacklisted	The IP Address is on the global ban list.
GE13	IP Not Whitelisted	The IP Address is not on the customer’s whitelist.
GE26	CallerID Not Enabled	The license key or ID does not have CallerID enabled.
General Transmission Warning
GW01	Expiring License	Your License Key is expiring soon. Please contact your sales representative for a new License Key.

Record Level Result Codes

Note

The Record Level result codes apply to the individual request records.

Code	Short Description	Long Description
AC - Address Change
AC01	Postal Code Change	The postal code was changed or added.
AC02	Administrative Area Change	The administrative area (state, province) was added or changed.
AC03	Locality Change	The locality (city, municipality) name was added or changed.
AC09	Dependent Locality Change	The dependent locality (urbanization) was changed.
AC10	Thoroughfare Name Change	The thoroughfare (street) name was added or changed due to a spelling correction.
AC11	Thoroughfare Type Change	The thoroughfare (street) leading or trailing type was added or changed, such as from “St” to “Rd.”
AC12	Thoroughfare Directional Change	The thoroughfare (street) pre-directional or post-directional was added or changed, such as from “N” to “NW.”
AC13	Sub Premise Type Change	The sub premise (suite) type was added or changed, such as from “STE” to “APT.”
AC14	Sub Premise Number Change	The sub premise (suite) unit number was added or changed.
AC15	Double Dependent Locality Change	The double dependent locality was added or changed.
AC16	SubAdministrative Area Change	The subadministrative area was added or changed.
AC17	SubNational Area Change	The subnational area was added or changed.
AC18	PO Box Change	The PO Box was added or changed.
AC19	Premise Type Change	The premise type was added or changed.
AC20	House Number Change	The house number was changed.
AC22	Organization Change	The organization was added or changed.
AE - Address Error
AE01	General Error	The address could not be verified. This is likely due to a missing or invalid locality or postal code.
AE02	Unknown Street	Could not match the input street to a unique street name. Either no matches or too many matches found.
AE03	Component Mismatch Error	The combination of directionals (N, E, SW, etc) and the suffix (AVE, ST, BLVD) is not correct and produced multiple possible matches.
AE05	Multiple Match	The address was matched to multiple records. There is not enough information available in the address to break the tie between multiple records.
AE08	Sub Premise Number Invalid	The thoroughfare (street address) was found but the sub premise (suite) was not valid.
AE09	Sub Premise Number Missing	The thoroughfare (street address) was found but the sub premise (suite) was missing.
AE10	Premise Number Invalid	The premise (house or building) number for the address is not valid.
AE11	Premise Number Missing	The premise (house or building) number for the address is missing.
AE12	Box Number Invalid	The PO (Post Office Box), RR (Rural Route), or HC (Highway Contract) Box number is invalid.
AE13	Box Number Missing	The PO (Post Office Box), RR (Rural Route), or HC (Highway Contract) Box number is missing.
AE14	PMB Number Missing	US Only. The address is a Commercial Mail Receiving Agency (CMRA) and the Private Mail Box (PMB or #) number is missing.
AE17	Sub Premise Not Required (Deprecated - See AS23)	A sub premise (suite) number was entered but the address does not have secondaries. (Deprecated - See AS23)
AN - Account Number Status
AN01	Valid Account Number	Account Number Validation Passed
AN02	Country Matched	Input Country matches the Account Number Country
AN10	IBAN	Account Number is identified as IBAN
AN11	SWIFT	Account Number is identified as SWIFT
AN30	Invalid Account Number	Account Number did not pass validation
AN31	Country Mismatched	Input Country does not match the Account Number Country
AS - Address Status
AS09	Foreign Address	The address is in a non-supported country.
AV - Address Verification
AV11	Administrative Area Partial	The address has been partially verified to the Administrative Area (State) Level, which is NOT the highest level possible with the reference data.
AV12	Locality Partial	The address has been partially verified to the Locality (City) Level, which is NOT the highest level possible with the reference data.
AV13	Thoroughfare Partial	The address has been partially verified to the Thoroughfare (Street) Level, which is NOT the highest level possible with the reference data.
AV14	Premise Partial	The address has been partially verified to the Premise (House or Building) Level, which is NOT the highest level possible with the reference data.
AV21	Administrative Area Full	The address has been verified to the Administrative Area (State) Level, which is the highest level possible with the reference data.
AV22	Locality Full	The address has been verified to the Locality (City) Level, which is the highest level possible with the reference data.
AV23	Thoroughfare Full	The address has been verified to the Thoroughfare (Street) Level, which is the highest level possible with the reference data.
AV24	Premises Full	The address has been verified to the Premise (House or Building) Level, which is the highest level possible with the reference data.
AV25	SubPremises Full	The address has been verified to the SubPremise (Suite) or PO Box Level, which is the highest level possible with the reference data.
DD - Date of Death
DD00	Not Deceased	This person is not deceased.
DD01	Deceased	This person is deceased.
DE - Data Error
DE	Data Field Error	The data field was empty.
ES - Email Status
ES01	Valid Email	This email address has valid syntax and belongs to a valid domain.
ES02	Invalid Email	This email was confirmed to be a invalid email.
ES03	Unknown Email	This email’s status is unknown due to unknown external factors. Please try again another time.
ES04	Mobile Email Address	The domain name was identified as a mobile email address and classified as not deliverable by the FCC.
ES05	Disposable Domain	The domain name of the submitted email was identified as a disposable domain.
ES06	Spamtrap Domain	The domain name of the submitted email was identified as a spamtrap. Mailing to this domain could result in the sender being blacklisted.
ES07	Accept All Server	The mail server is an accept all server. Accept-All domains is set in a way that makes all emails seem valid.
ES08	Role Address	This Email address was created as a group, ex: sales@, support@, or postmaster@.
ES09	Protected Mailbox Caution	The mail provider for this email address may be quick to classify senders as spam and will not respond to our requests. Mailbox validation is not possible at this time and the mailbox may or may not exist. We recommend proceeding with caution if emailing numerous records to this mail domain.
ES10	Syntax Changed	The syntax of the submitted email address was changed.
ES11	Top Level Domain Changed	The top level domain of the submitted email address was changed.
ES12	Domain Changed (Spelling)	The domain of the submitted email address was corrected for spelling.
ES13	Domain Changed (Update)	The domain of the submitted email address was updated due to a domain name change.
ES20	Verify (Precision: Domain Result)	The email is considered valid, but did not have the mailbox verified and not found in our mailbox database.
ES21	Verify (Precision: Cached Mailbox Result)	The mailbox was found to be already validated in our mailbox database.
ES22	Verify (Precision: Real-time Mailbox Result)	The mailbox validation was performed in real-time.
ES23	Verify (Precision: Unicode Result)	Unicode Detected: We do not support Unicode at this time for realtime mailbox validation. Domain and cache check only.
ES24	Verify (Precision: Pending Mailbox Result)	The mail provider has been known to send a delayed response so it is possible that the pending status will change within the next 24 hours. You may want to resubmit this input at a later time as an update may be possible.
EE - Email Error
EE01	Email Syntax Error	There is a syntax error in the submitted email address.
EE02	Email Domain Not Found	A Domain of the submitted email address was not found.
EE03	Email Server Not Found	The mail server of the submitted email address was not found.
EE04	Invalid Email	An invalid mailbox was detected (i.e. noreply).
GEO-GS - GeoCode Status
GS01	Geocoded to Street Level	The record was coded to the street level (Zip+4 for US, full postal code for CA).
GS02	Geocoded to the Neighborhood Level	The record was geocoded down to neighborhood level (Zip+2 for US).
GS03	Geocoded to Community Level	The record was coded to the community level (ZIP centroid for US, 3-digit postal code for CA).
GS04	Geocoded to State Level	The record was geocoded to the state (administrative area) level.
GS05	Geocoded to Rooftop Level	The record was geocoded down to the rooftop level, meaning the point is within the property boundaries, usually the center.
GS06	Geocoded to Interpolated Rooftop Level	The record was geocoded down to the rooftop level using interpolation (educated estimations using street coordinates). The point may be in or close to the property boundaries.
GEO-GE - GeoCode Error
GE01	Regional Geocode Not Found	Geocode could not be appended for the input locality or postal code.
GE02	No Geocode for Input Address	The input address did not provide enough valid information to append a geocode.
KE - Personator Identity Error Codes
KE01-Personator	Timeout	Querying the data sources/providers has timed out. Retry sending the web service request.
KE02-Personator	Data Provider Unavailable	The data provider is currently unavailable. Please wait and try again at a later time.
KV - Verification Match
KV01	Address matched	Complete match found for address.
KV10	Postal code matched	Complete match found for postal code.
KV11	Administrative area (state/province) matched	Complete match found for administrative area (state/province).
KV12	Locality matched	Complete match found for locality.
KV13	Thoroughfare/street matched	Complete match found for thoroughfare.
KV14	Premise/house number matched	Complete match found for premise/house number.
KV15	Subpremise matched	Complete match found for subpremise.
KV02	National ID matched	Complete match found for national ID.
KV03	First/given/forename matched	Complete match found for first/given/forename name.
KV31	First Initial Matched	Match found for first initial (from first/given name).
KV32	Partial First Name Match	Partial match found for first/given/forename name.
KV04	Last/surname matched	Complete match found for last/surname.
KV41	Partial Last Name Match	Partial match found for last/surname.
KV05	Phone number matched	Complete match found for phone number.
KV50	Last 4 digits of phone matched	Match found for the last 4 digits of the phone number.
KV06	Email matched	Complete match found for the email address.
KV07	Date of birth matched	Complete match found for the date of birth.
KV70	Day of birth matched	Match found for the day of birth.
KV71	Month of birth matched	Match found for the month of birth.
KV72	Year of birth matched	Match found for the year of birth.
KV08	Organization matched	Complete match found for the organization/company.
KV91	First and last name swap match	First name and last name swapped for a full match.
KV92	Middle and first name swap match	Middle name and first name swapped for a full match.
KV93	Middle and last name swap match	Middle and last name swapped for a full match.
KV94	Middle and first name swap partial match	Middle and first name swapped for a partial match.
KV95	Middle and last name swap partial match	Middle and last name swapped for a partial match.
NS - Name Status
NS01	Parsing Successful	Name parsing was successful.
NS02	Error Parsing	An error was detected. Please check for a name error code.
NS03	First Name Spelling Corrected	The spelling in the first name field was corrected.
NS04	First Name 2 Spelling Corrected	The spelling in the second first name field was corrected.
NS05	First Name 1 Found	FirstName1 was found in our census table of names. Very likely to be a real first name.
NS06	Last Name 1 Found	LastName1 was found in our census table of names. Very likely to be a real last name.
NS07	First Name 2 Found	FirstName2 was found in our census table of names. Very likely to be a real first name.
NS08	Last Name 2 Found	LastName2 was found in our census table of names. Very likely to be a real last name.
NS99	Company Name Standardized	The company name was standardized.
NE - Name Error
NE01	Unrecognized Format	Format of Input string was not recognized or too long to represent a valid name.
NE02	Multiple First Names Detected	Multiple first names were detected and could not be accurately genderized.
NE03	Vulgarity Detected	A vulgarity was detected in the name.
NE04	Suspicious Word Detected	The name contained words found on the list of nuisance names, such as “Mickey Mouse.”
NE05	Company Name Detected	The name contained words normally found in a company name.
NE06	Non-Alphabetic Character Detected	The name contained a non-alphabetic character.
NE08	Unicode/Non-Latin Name Input	Unicode characters detected on input. We do not support Unicode at this time; the input is returned as-is.
NE99	Company Standardization Not Needed	Company name standardization was attempted, but did not produce a different result.
PS - Phone Status
PS01	Valid Phone	The phone number has been verified as valid.
PS02	7-Digit Match	The first 7-digits of the phone number have been verified, but activity cannot be confirmed.
PS03	Corrected Area Code	NewAreaCode contains corrected area code that was changed according to the postal code it falls into.
PS04	Demo Mode	Demo mode is active and the phone number is outside the range of phone numbers allowed by the Demo.
PS06	Updated Area Code	The area code was changed due to an area code split. The updated code is located within NewAreaCode.
PS07	Cellular Line	On activation, the exchange type of the phone number was designated as a cellular number, but current status cannot be confirmed.
PS08	Land Line	On activation, the exchange type of the phone number was designated as a land line, but current status cannot be confirmed.
PS09	VOIP Line	On activation, the exchange type of the phone number was designated as a VOIP line, but current status cannot be confirmed.
PS10	Residential Number	The phone number belongs to a residence.
PS11	Business Number	The phone number belongs to a business.
PS12	SOHO Number	The phone number belongs to a small office or home office.
PS13	Toll Free Number	Global Phone Object Only. The phone number is a toll free number.
PS14	Special Number	Global Phone Object Only. This is a phone number with premium service, data, internet access, etc. which all incur a higher charge rate.
PS15	Misc Type	The phone number is used for other services (calling cards, national numbers, directory assistance, mass communications, etc.)
PS16	Unknown Type	Phone type is unknown due to external errors. Please try again at another time.
PS17	Live number	Phone is live, callable and/or able to receive SMS.
PS18	Do Not Call	The phone number was found in Melissa’s proprietary Do Not Call list.
PS20	Low Confidence	Number exists within a block of registered phone numbers.
PS21	Medium Confidence	Number was found to already be validated in our phone database.
PS22	High Confidence	Number was verified against current dialing equipment.
PS30	Premium Timeout	Querying Premium has timed out, but has continued to run in the background. Query later to obtain the cached results.
PS31	CallerID Timeout	Querying CallerID has timed out, but has continued to run in the background. Query later to obtain the cached results.
PE - Phone Error
PE01	Invalid Phone	The area code/phone number does not exist in our database or contains non-numbers.
PE02	Blank Phone	The phone number is blank.
PE03	Bad Phone	The phone number has too many or too few digits.
PE04	Multiple Match	Two or more possible area codes are available as a fix and their distance is too close to choose one over the other.
PE05	Bad Prefix/Prefix +1	The phone prefix or first 7-digits do not exist in our database.
PE06	Bad Postal Code	The input postal code is invalid.
PE08	No Country Input	Global Phone Object Only. The input country is blank and the phone number has no ‘+’ sign.
PE09	Out of Range Suffix	Global Phone Object Only. The subscriber’s phone number suffix is out of range.
PE10	Invalid Input Country	Global Phone Object Only. The input country in not valid.
PE11	Disconnected Phone	Phone number has been disconnected.

Record Level Product Codes

Note

The Record Level product codes are unique to Personator Identity.

Code	Description
Address Type US
A	Alias
F	Firm or Company
H	Highrise or Business Complex
G	General Delivery
P	PO Box
R	Rural Route
S	Street or Residential
Address Type Canada
1	Street
2	Street Served by Route and GD
3	Lock Box
4	Route Service
5	General Delivery
B	LVR Street
C	Government Street
D	LVR Lock Box
E	Government Lock Box
L	LVR General Delivery
K	Building
Address Type Austria
T	A door number (Tür) is expected for this address to be considered complete.
Address Type France
C	This address is a CEDEX address. These are addresses classified as “Courier d’entreprise à distribution exceptionnelle” or “special business mail” by La Poste. They are given their own postal priority and usually large organizations.
Address Type Great Britain
L	This address is identified as having a large user postal code. This is due to the large volume of mail received at that address, or because a PO Box or Selectapost service has been set up.
S	This address is identified as having a smaller user postal code. This means this postal code will have usually around 15 delivery points but never more than 100.
Address Type Switzerland
M	Domicile and specialist addresses
S	Domicile addresses only
T	Specialist postcodes only
F	Company postcodes
P	In-house Swiss Post postcodes (delivery post office information on bundle labels or bag addresses).
Delivery Indicator Code
R	Residence
B	Business
U	Unknown
Gender Type Code
M	Male
F	Female
U	Unknown
N	Neutral (Pat, Chris, etc.)
Postal Code Type
[Empty]	Regular postal code
M	Military Postal Code
P	PO Box Postal Code
U	Unique Postal Code usually assigned to a large organization or government institution.