Quickstart#

Introduction#

Personator™ Consumer Web Service provides CASS/DPV certified address verification and optionally leverages comprehensive Consumer data for all-in-one email, phone, name checking, name to address verification, move update, and appending missing information, demographics, enrichments.

Personator Consumer can be used to:

  • Verify, Correct, & Standardize names, addresses, phones and emails

  • Retrieve move information

  • Append demographics

  • Append Geographic and Census data

System Requirements#

  • SSL/TLS 1.2+

Getting Started - What Can I Do?#

Append: Append Data for an Address#

Append missing data for an address (as the centric data point).

Endpoint#

/V3/WEB/ContactVerify/doContactVerify

Click here to go to the full endpoint documentation.

Try it Now#

curl -X GET "https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?\
t=\
&id={{customerId}}\
&act=Append\
&opt=Append:blank\
&a1=22382%20Avenida%20Empresa\
&city=Rancho%20Santa%20Margarita\
&state=California\
&format=JSON" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Append: Append Data for an Email#

Append missing data for an email address (as the centric data point).

Endpoint#

/V3/WEB/ContactVerify/doContactVerify

Click here to go to the full endpoint documentation.

Try it Now#

curl -X GET "https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?\
t=\
&id={{customerId}}\
&act=Append\
&opt=Append:blank\
&email=info@melissa.com\
&format=JSON" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Append: Append Data for a Phone#

Append missing data for a phone number (as the centric data point).

Endpoint#

/V3/WEB/ContactVerify/doContactVerify

Click here to go to the full endpoint documentation.

Try it Now#

curl -X GET "https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?\
t=\
&id={{customerId}}\
&act=Append\
&opt=Append:blank\
&phone=800-635-4772\
&format=JSON" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Check: Check an Address by City/State#

Validate an address with city/state and correct it, if possible.

Endpoint#

/V3/WEB/ContactVerify/doContactVerify

Click here to go to the full endpoint documentation.

Try it Now#

curl -X GET "https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?\
t=\
&id={{customerId}}\
&act=Check\
&opt=\
&a1=22382%20Avenida%20Empresa\
&city=Rancho%20Santa%20Margarita\
&state=California\
&format=JSON" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Check: Check an Address by Postal Code#

Validate an address with a postal code and correct it, if possible.

Endpoint#

/V3/WEB/ContactVerify/doContactVerify

Click here to go to the full endpoint documentation.

Try it Now#

curl -X GET "https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?\
t=\
&id={{customerId}}\
&act=Check\
&opt=\
&a1=22382%20Avenida%20Empresa\
&postal=92688\
&format=JSON" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Check: Check an Email#

Validate an email address and correct it, if possible. US and Canada only.

Endpoint#

/V3/WEB/ContactVerify/doContactVerify

Click here to go to the full endpoint documentation.

Try it Now#

curl -X GET "https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?\
t=\
&id={{customerId}}\
&act=Check\
&opt=\
&email=info@melissa.com\
&format=JSON" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Check: Check a Name#

Validate a name and correct it, if possible. US and Canada only.

Endpoint#

/V3/WEB/ContactVerify/doContactVerify

Click here to go to the full endpoint documentation.

Try it Now#

curl -X GET "https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?\
t=\
&id={{customerId}}\
&act=Check\
&opt=\
&first=\
&full=Ray%20Melissa\
&last=\
&format=JSON" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Check: Check a Phone Number#

Validate a phone number and correct it, if possible. US and Canada only.

Endpoint#

/V3/WEB/ContactVerify/doContactVerify

Click here to go to the full endpoint documentation.

Try it Now#

curl -X GET "https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?\
t=\
&id={{customerId}}\
&act=Check\
&opt=\
&phone=8006354772\
&format=JSON" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Move: Check for a Move#

Given a previous address, check to see if an individual or business has moved.

Endpoint#

/V3/WEB/ContactVerify/doContactVerify

Click here to go to the full endpoint documentation.

Try it Now#

curl -X GET "https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?\
t=\
&id={{customerId}}\
&act=Move\
&opt=\
&a1=22382%20Avenida%20Empresa\
&city=Rancho%20Santa%20Margarita\
&state=California\
&comp=Melissa%20Data\
&first=\
&full=Ray%20Melissa\
&last=\
&format=JSON" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Verify: Verify with Centric Address#

Verify your data by correlating the relationship between it and an address as the centric data point.

Endpoint#

/V3/WEB/ContactVerify/doContactVerify

Click here to go to the full endpoint documentation.

Try it Now#

curl -X GET "https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?\
t=\
&id={{customerId}}\
&act=Verify\
&opt=CentricHint:address\
&a1=22382%20Avenida%20Empresa\
&city=Rancho%20Santa%20Margarita\
&comp=Melissa\
&state=California\
&postal=92688\
&format=JSON" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Verify: Verify with Centric Email#

Verify your data by correlating the relationship between it and an email address as the centric data point.

Endpoint#

/V3/WEB/ContactVerify/doContactVerify

Click here to go to the full endpoint documentation.

Try it Now#

curl -X GET "https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?\
t=\
&id={{customerId}}\
&act=Verify\
&opt=CentricHint:email\
&email=info@melissa.com\
&comp=Melissa\
&format=JSON" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Verify: Verify with Centric Phone#

Verify your data by correlating the relationship between it and a phone number as the centric data point.

Endpoint#

/V3/WEB/ContactVerify/doContactVerify

Click here to go to the full endpoint documentation.

Try it Now#

curl -X GET "https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?\
t=\
&id={{customerId}}\
&act=Verify\
&opt=CentricHint:phone\
&comp=Melissa\
&phone=8006354772\
&format=JSON" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Verify: Verify with Centric SSN#

Verify your data by correlating the relationship between it and a Social Security Number (SSN) as the centric data point.

Endpoint#

/V3/WEB/ContactVerify/doContactVerify

Click here to go to the full endpoint documentation.

Try it Now#

curl -X GET "https://personator.melissadata.net/v3/WEB/ContactVerify/doContactVerify?\
&act=Verify\
&format=JSON\
&id={{customerId}}\
&opt=CentricHint:ssn\
&t=\
&ss={{required}}" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Sample Code#

Language

Repository

C# .NET

melissa_favicon MelissaData/PersonatorConsumer-Dotnet

Python3

melissa_favicon MelissaData/PersonatorConsumer-Python3

Postman Collection

melissa_favicon MelissaData/PersonatorConsumer-Postman