Consumer Verification

Use Consumer Verification endpoint to validate, standardize, and verify consumer contact data.

Operations

Verify a consumer

Request

The service requires at least one of the following input combinations:

Set A - a1, postal

Set B - a1, city, state

Set C - a1, lastline

Set D - email

Set E - phone

Set F - full

Set G - ip

Set H - ff

Set I - mak

Set J - mik

Note: The minimum input requirements differ depending on the Action(s) selected. Please check the documentation for more details.

Query

actArray of stringsrequired

Actions - The action(s) to take. Delimit multiple actions with a ,.

Items Enum:"Check""Verify""Move""Append"

Example:act=Append

colsstring

Columns - The column names or groups to be output.

Entering the column name will return the column. Specifying a group name will return all columns in the group.

Delimit multiple columns with a ,.

For example: ColumnName,ColumnName.

Columns:

[No Group] - These fields have no group and have to be requested by the field name.

DateLastConfirmed
EstimatedHomeValue
MelissaIdentityKey
MoveDate
Occupation
OwnRent
PhoneCountryCode
PhoneCountryName
Plus4
PrivateMailBox
Suite

GrpAddressDetails - Address Details

AddressTypeCode
CarrierRoute
CityAbbreviation
CountryCode
CountryName
DeliveryIndicator
DeliveryPointCheckDigit
DeliveryPointCode
StateName
UrbanizationName
UTC

GrpCensus - Census Details

CBSACode
CBSADivisionCode
CBSADivisionLevel
CBSADivisionTitle
CBSALevel
CBSATitle
CensusBlock
CensusTract
CongressionalDistrict
CountyFIPS
CountyName
PlaceCode
PlaceName

GrpCensus2 - Additional Census Details

CensusKey
CountySubdivisionCode
CountySubdivisionName
ElementarySchoolDistrictCode
ElementarySchoolDistrictName
SecondarySchoolDistrictCode
SecondarySchoolDistrictName
UnifiedSchoolDistrictCode
UnifiedSchoolDistrictName
StateDistrictUpper
StateDistrictLower

GrpGeocode - Geocode Details

Latitude
Longitude

GrpDemographicBasic - Basic Demographics

ChildrenAgeRange
CreditCardUser
DateOfBirth
DateOfDeath
DemographicsGender
DemographicsResults
Education
EthnicCode (Deprecated)
EthnicGroup (Deprecated)
HouseholdIncome
HouseholdSize
LengthOfResidence
MaritalStatus
MedianHouseholdIncome
PoliticalParty
PresenceOfChildren
PresenceOfSenior

GrpIPAddress - IP Address Details

DistanceAddressToIP
IPAddress
IPCity
IPConnectionSpeed
IPConnectionType
IPContinent
IPCountryAbbreviation
IPCountryName
IPDomainName
IPISPName
IPLatitude
IPLongitude
IPPostalCode
IPProxyDescription
IPProxyType
IPRegion
IPUTC

GrpNameDetails - Name Details

Gender
Gender2
NameFirst
NameFirst2
NameLast
NameLast2
NameMiddle
NameMiddle2
NamePrefix
NamePrefix2
NameSuffix
NameSuffix2
Salutation

GrpParsedAddress - Parsed Address Details

AddressDeliveryInstallation
AddressHouseNumber
AddressLockBox
AddressPostDirection
AddressPreDirection
AddressPrivateMailboxName
AddressPrivateMailboxRange
AddressRouteService
AddressStreetName
AddressStreetSuffix
AddressSuiteName
AddressSuiteNumber

GrpParsedEmail - Parsed Email Details

DomainName
MailboxName
TopLevelDomain

GrpParsedPhone - Parsed Phone Details

AreaCode
NewAreaCode
PhoneExtension
PhonePrefix
PhoneSuffix

idany, (password)required

Required. The License Key issued by Melissa.

Example:id={REPLACE-WITH-YOUR-LICENSE-KEY}

optstring

Options - Specify which options to use for the selected action. List of options in <OptionName>:<Parameter> format. Multiple options are delimited with a ;.

For example: OptionName:Parameter;OptionName:Parameter.

AdvancedAddressCorrection:< On | Off > - Uses the name input to perform more advanced address corrections. This can correct or append house numbers, street names, cities, states, and ZIP codes. Default of Off means no advanced address corrections will occur.
AdvancedAddressType:< On | Off > - This option allows you to select whether to return the simplified address type codes or the advanced and more complete address type codes. Default of Off means only Default Address Types are returned (S, G, M, P, R, and U).
AliasMode:< ConvertAlias | PreserveAlias > - Option to convert an address to the USPS preferred street name or preserve the original address. Default of ConvertAlias will convert the street address alias to the USPS preferred street name.
Append:< Blank | CheckError | Always > - Determines the behavior when appending information. Default of Blank returns information only when the input field is blank.
CentricHint:< Auto | Address | Phone | Email > - This option tells the service which piece of information to use as the primary pivot when verifying information. Default of Auto first uses Address if available, followed by Phone if no Address is available, and lastly Email if neither Address nor Phone are available.
CorrectFirstName:< On | Off > - Default of On allows common spelling corrections for the FirstName field.
CorrectSyntax:< On | Off > - Default of On corrects the syntax of the Email field.
DatabaseLookup:< On | Off > - Default of On will attempt to verify domain names using a database of valid domains.
DecennialCensusKey:< Off | 2020 | 2010 > - Set the preferred Census information returned, whether the latest one or the decennial version. Default of Off returns the latest Census information available.
Demographics:< Yes | Mask | MaskOnly | ValueOnly > - Determines the data masking of demographics columns. Default of Yes means no data masking will be performed.
Diacritics:< Auto | On | Off > - Determines whether or not French language characters are returned. Default of Auto will only return those characters if they are in the input.
EmailAppendFilter:< [blank] | CatchAll | SpamTrap > - option to prevent certain categories of emails to append, including accept-all/catch-all emails and spam trap emails. Default of [blank] means no filtering will be done.
FuzzyLookup:< On | Off > - Determines whether or not to apply fuzzy matching algorithms to the input domain for correction. Default of On will apply fuzzy matching correction to the domain.
GenderAggression:< Neutral | Conservative | Aggressive > - Sets how aggressive genderization is for neutral first names. Default of Neutral sets gender aggression to neutral.
GenderPopulation:< Mixed | Male | Female > - Sets the gender balance of the source data, either predominantly male, female, or mixed (evenly split). Default of Mixed sets source data gender balance to mixed.
LongAddressFormat:< Off | On | Auto > - Controls how abbreviations of suffixes and directionals are handled when standardizing a street address. Default of Off will abbreviate suffixes and directionals.
MiddleNameLogic:< ParseLogic | HypenatedLast | MiddleName > - Determines the handling of middle names. Default of ParseLogic means that middle names that are typically last names are considered to be part of a hyphenated last name.
NameHint:< Varying | DefinitelyFull | VeryLikelyFull | ProbablyFull | ProbablyInverse | VeryLikelyInverse | DefinitelyInverse | MixedFirstName | MixedLastName > - Sets the name hint for the input name. Default of Varying means if necessary, statistical logic will be employed to determine name order, with no bias toward either name order.
SalutationFormat:< Formal | Informal | FirstLast > - Sets the salutation format for the response. Default of Formal Sets the salutation format to formal.
StandardizeCasing:< On | Off > - Determines whether to standardize casing in the email field before any checking occurs. Default of On will standardize all letters to lower case.
StandardizeCompany:< On | Off > - Determines whether to standardize the CompanyName field. Default of On will perform standard abbreviation, capitalization, and punctuation on the CompanyName field.
UpdateDomain:< On | Off > - Determines whether to update the domain name. Default of On will update the domain if it is out of date.
UsePreferredCity:< Off | On > - Determines whether to substitute the preferred city name for all vanity names when verifying an address. Default of Off means no substitution will occur.

Example:opt=Append:blank

tstring

Transmission Reference - Serves as a unique identifier for this set of records.

Example:t=Test

a1stringrequired

Address Line 1.

Example:a1=22382 Avenida Empresa

a2string

Address Line 2.

ageapproxstring

Age Approximate - Filter results to return individuals who are within a year of the provided age.

agegtstring

Age Greater Than - Filter results to return individuals whose age is greater than the provided age.

ageltstring

Age Less Than - Filter results to return individuals whose age is less than the provided age.

bdaystring

Birth Day - In DD format.

bmostring

Birth Month - In MM format.

byrstring

Birth Year - In YYYY format.

citystringrequired

City Name.

Example:city=Rancho Santa Margarita

compstring

Company Name.

ctrystring

Country - This can only take in variations of US or Canada. All other countries will return AS09 (Foreign Address). Invalid or blank inputs will default to US and Canada.

emailstring

Email Address.

firststring

First Name.

formatstring

Format of the request.

Enum:"json""xml"

Example:format=JSON

ffstring

FreeForm - The delimited or undelimited free form input that will be parsed by the service.

fullstring

Full Name - Name parsing will only happen if the first name and last name fields are blank.

ipstring

IP Address.

lastlinestring

The city, state, and ZIP.

laststring

Last Name.

makstring

Melissa Address Key - A proprietary unique key identifier for an address.

mikstring

Melissa Identity Key - A unique number for each individual.

phonestring

Phone Number.

postalstring

Postal or ZIP Code.

statestringrequired

US State.

Example:state=California

Acceptstringrequired

Format of the response.

Enum:"application/json""application/xml""*/*"

Example:*/*

Content-Typestringrequired

Format of the request.

Enum:"application/json""application/xml"

curl -i -X GET \
  'https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?act=Append&id=%7BREPLACE-WITH-YOUR-LICENSE-KEY%7D&a1=22382%20Avenida%20Empresa&city=Rancho%20Santa%20Margarita&state=California' \
  -H 'Accept: */*' \
  -H 'Content-Type: application/json'

Responses

Successful response

Body

TotalRecordsstring

Total number of records.

TransmissionReferencestring

A pass-through of the input TransmissionReference field.

TransmissionResultsstring

Lists error codes from any errors caused by the most recent request as a whole. For more information, see Personator Consumer Result Codes.

Versionstring

The current service version number.

RecordsArray of objects

Response

{
  "Records": [
    { … }
  ],
  "TotalRecords": "1",
  "TransmissionReference": " ",
  "TransmissionResults": " ",
  "Version": "5.6.13"
}