Personator Consumer:FAQ

← Personator

Service Speed

What kinds of speeds/throughput can the Personator Web Service do?

The following are the average speeds for 1 Thread vs 10 Threads, for different combinations of Actions selected:

Action	Throughput (rec / hour) Average 1 Thread	Throughput (rec / hour) Average 10 Threads
Check Only	150K	600K-750K
Check Only with Express hint	200K	900K-1M
Check + Verify	80K	300K-400K
Check + Append	80K	300K-400K
Check + Move	30K	150K-250K
All Actions	30K	150K-250K

Minimum Input Requirements

What are the minimum input requirements for each Action?

Check

Must satisfy any one of these combinations:

1. (Address and Zip)
2. (Address, City and State)
3. Phone Number
4. Email
5. Full Name
6. (First Name and Last Name)

If combinations of fields are selected, make sure that the minimum requirements are always met for those that have 2 or more fields required.

So for example, if a user selects a Phone Number and Address, it should not pass unless they also input either a Zip or the City & State

Verify

User must satisfy 2 or more of the following conditions:

1. (Address, City and State) OR (Address and Zip) – must first make sure that the minimum requirements for an address is met
2. Phone
3. Email
4. (Full Name) OR (Last Name Only) OR (First and Last Name) – must first make sure that the minimum requirements for a Name is met
5. Company

So for example, satisfying condition 1 and 5 will meet the Minimum Input Requirements for Verify.

All combinations of 2 or more will satisfy the minimum input requirements for Verify with the exception of combination 4 and 5. Therefore, selecting Full Name and Company does not satisfy the minimum input requirements for Verify.

Move Update

User must satisfy at least one of the following combinations:

1. Address and Full Name
2. Address, First and Last Name
3. Address and Company Name

Append

The Minimum Input requirements for Append will be dependent on which field you are trying to append information for. For example, appending missing names will have a different minimum input, as opposed to appending addresses. The following are the list elements that can be appended and the minimum requirements for each:

Append Names/Company

Must have at least one of these:

1. (Address, City and State) OR (Address and Zip) – must first make sure that the minimum requirements for an address is met
2. Phone
3. Email

Append Addresses

Must have at least one of these:

1. Phone
2. Email

Append GeoLocations

This one is going to be a little different. The minimum input requirements will depend on other Options you currently have selected.

If Only Append GeoLocations is Selected, the user must satisfy at least 1 of the following minimum input requirements:

1. (Address, City and State) OR (Address and Zip) – must first make sure that the minimum requirements for address are first met
2. Phone Number – Personator can give you Phone Lat Long.

If Append GeoLocations and either Append Addresses or Append Phones are also Selected, the user must satisfy at least 1 of the following minimum input requirements:

1. (Address, City and State) OR (Address and Zip) – must first make sure that the minimum requirements for address are first met
2. Phone Number
3. Email Address – You can append addresses or phone numbers using just emails, which will then give you the Appended Address’ or Phone Numbers’ Lat/Long

Append Phones

Must have at least one of these:

1. (Address, City and State) OR (Address and Zip) – must first make sure that the minimum requirements for an address is met
2. Email

Append Emails

Must have at least one of these:

1. (Address, City and State) OR (Address and Zip) – must first make sure that the minimum requirements for an address is met
2. Phone

Data Sources

Where does the Data from the Personator Web Service Come from?

The Personator Database is compiled from several sources and industries such as Property Information Data, Loan Data, Credit Data, Telephone Data, Voter Data, and several other private sources. The final combined database merges all contact records including Addresses, Phone Numbers, Emails and Names amounting to over a billion records of historical and current information. This data is then exposed through the Personator Web Service which allows for checking, verifying, appending and updating contact records. Since the service revolves heavily around the contents of the data, the exact provider for the sources is not something we can disclose at the moment as we prefer to keep this information private in order to maintain the product’s uniqueness and value in the industry.

NCOA and Personator Move Differences

What is the difference between USPS National Change of Address and Personator Move?

Users who wish to make use of the USPS National Change of Address (NCOA) for detecting move addresses should use the Smart Mover Web Service. This is commonly used by users who wish to avail of USPS discounts for mailing. Personator’s Move capability on the other hand, offers a more comprehensive and extensive coverage for detecting move addresses through the use of a massive consolidated data set compiled from several different sources. Here are some of the advantages of using Personator Move that are not available through NCOA:

Non-NCOA Moves

The USPS limits its move capabilities only to people who file an NCOA Form with the Post Office. Personator Move is not limited to this, as it is able to provide Moves for even those people who do not file an NCOA form with the USPS.

10 Year Detection

Another limitation of NCOA moves is that it can only move a person who has filed an NCOA form in the last 4 years. Personator Move on the other hand can give you the latest address for a person who has moved within the last 10 years.

Chained Moves

If a person has moved 3 times within the last 4 years, NCOA will only be able to give you the most recent move based on the last previous address. Personator Move on the other hand has the ability to chain all of that person’s moves and provide you with the latest address, regardless of which of the 3 previous addresses you enter.

Comprehensiveness

Personator boasts an estimated 400 million move records in the Database. Which is a much much larger coverage compared to NCOA.

Maxiumum Length Response

What is the Maximum Length Response that we can Expect to Receive for Each Field in Personator?

The Web Service Response, in general, does not have a maximum length for each Response Field. This is to avoid any form of truncation when returning information from our data. We do however have recommended values which you can set for defining field lengths in your table.

Response Field	Length
MD_NameFull	256
MD_CompanyName	128
MD_Results	100
MD_EmailAddress	75
MD_PlaceName	60
MD_CBSATitle	55
MD_CBSADivisionTitle	55
MD_AddressExtras	50
MD_AddressLine2	50
MD_AddressLine1	50
MD_DomainName	50
MD_AddressStreetName	40
MD_NameLast2	35
MD_NameFirst2	35
MD_NameFirst	35
MD_City	35
MD_CBSALevel	35
MD_NameLast	35
MD_CBSADivisionLevel	35
MD_AddressTypeCode	31
MD_PhoneNumber	30
MD_StateName	25
MD_CountyName	25
MD_CountryName	25
MD_MailboxName	25
MD_NamePrefix	20
MD_NameSuffix	20
MD_NamePrefix2	20
MD_AddressRouteService	20
MD_Suite	20
MD_Salutation	20
MD_NameMiddle2	20
MD_NameMiddle	20
MD_AddressLockBox	20
MD_NameSuffix2	20
MD_AddressDeliveryInstallation	20
MD_State	15
MD_PrivateMailBox	15
MD_UrbanizationName	15
MD_PhoneExtension	14
MD_CityAbbreviation	13
MD_Latitude	12
MD_Longitude	12
MD_DeliveryPointCheckDigit	11
MD_AddressKey	11
MD_CountryCode	10
MD_AddressPrivateMailboxName	10
MD_AddressPrivateMailboxRange	10
MD_AddressSuiteName	10
MD_TopLevelDomain	10
MD_PostalCode	10
MD_AddressStreetSuffix	10
MD_AddressSuiteNumber	10
MD_PlaceCode	7
MD_UTC	6
MD_CensusTract	6
MD_AddressPreDirection	5
MD_CBSADivisionCode	5
MD_CBSACode	5
MD_AddressPostDirection	5
MD_CountyFIPS	5
MD_PhoneSuffix	4
MD_AddressHouseNumber	4
MD_CensusBlock	4
MD_CarrierRoute	4
MD_Plus4	4
MD_PhonePrefix	3
MD_AreaCode	3
MD_NewAreaCode	3
MD_DeliveryPointCode	2
MD_CongressionalDistrict	2
MD_Gender	1
MD_DeliveryIndicator	1
MD_Gender2	1

Demographics

What are the types of demographics that Personator can return?

Personator can return the following demographics:

Date of Birth

This will be in the format YYYYMM. So the accuracy will only be to the Month.

Date of Death

We will be returning the full date of death in the format YYYYMMDD

Presence of Children

Indicates the presence of children in the household

Value
Unknown
No Children Present
Children Present

Marital Status

Indicates whether the Individual is married or not

Value
Unknown
Definitely Single
Inferred Single
Inferred Married
Definitely Married

Rent/Own

Indicates whether the Individual is either a renter or an owner or property

Value
Unknown
Definite Renter
Inferred Renter
Inferred Owner
Definite Owner

Demographic Gender

Indicates Gender based on Demographics Data

Value
Unknown
Male
Female
Neutral

Household Income

Indicates the range of the Household’s Income

Value
Unknown
$0-$15,000
$15,001-$20,000
$20,001-$30,000
$30,001-$40,000
$40,001-$50,000
$50,001-$60,000
$60,001-$70,000
$70,001-$80,000
$80,001-$90,000
$90,001-$100,000
$100,001-$125,000
$125,001-$150,000
$150,001+

Length of Residence

Indicates the range of the Individual’s length of residency in his current address

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

Occupation

Indicates the category for the Individual’s Occupation

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