Use this endpoint to do contact verification.
Personator Identity
The Personator Identity is a single Cloud API that checks and verifies your client/contact data globally. An individual's data can easily be verified against trusted reference data.
These data verification points include:
- Name
- Address
- Phone
- Date of Birth
- National ID
Documentation
Useful Resources
Product Page
Support Center
The actions the service will perform on input data. For every request, a Check action is always performed on the input.
Check: Determines whether the data within a submitted record is valid, e.g. whether or not a given postal code contains the given city. It can also make limited corrections and appends to the data. Check looks at each data point separately.Screen: Screens the provided input against various government sanctions and watchlists and returns back a list of matches. For a list of used watchlists, see Personator Identity Watchlists.Verify: After the data has been checked, identity verification is performed and result codes (KV*) are returned to indicate what pieces of input data have been matched against trusted referenced data.
Transmission Reference - Serves as a unique identifier for this set of records.
Address Options - To be set when an address is being validated during the Check action.
List options in the following format, with multiple options delimited with a comma ,.
For example: OptionName:Parameter,OptionName:Parameter.
CountryOfOrigin:< ISO2, ISO3, or ISO# >- This is used to determine whether or not to include the country name as the last line in FormattedAddress.DeliveryLines:< On | Off >- This options allows you to specify if the Address Lines 1-8 should contain just the delivery address or the entire address. Default of 'Off' will return the entire address.LineSeparator:< SEMICOLON | PIPE | CR | LF | CRLF | TAB | BR >- This is the line separator used for the FormattedAddress result. Default ofSEMICOLONwill use a semicolon;.OutputScript:< NOCHANGE | LATIN | NATIVE >- This is the script type used for all applicable fields. Default ofNOCHANGEwill return the same script that is sent in.
Email Options - To be set when an email is being validated during the Check action.
List options in the following format, with multiple options delimited with a comma ,.
For example: OptionName:Parameter,OptionName:Parameter.
DomainCorrection:< On | Off >- Default ofOnactivates fuzzy email domain correction if the domain is a suspected typo.TimeToWait:< #[5 - 45] >- TimeToWait allows you to select how long (in seconds) that you would like our Cloud API to wait on a single email before it times out. Select a smaller number if time is of essence, or longer if you would prefer more accurate results. Defaults to25.VerifyMailBox:< Express | Premium >- Default ofExpressquickly validates against database of known email addresses.Premiumhas a real time check performed to determine email deliverability.
Name Options - To be set when a name is being validated during the Check action.
- Full or normal name order is: Prefix, First, Middle, Last, Suffix.
- Inverse name order is: Last, Suffix, Prefix, First, Middle.
Either the Code or Name can be used to set the action. List options in the following format, with multiple options delimited with a comma ,.
For example: OptionName:Parameter,OptionName:Parameter.
CorrectFirstName:< ON | OFF >- This option enables or disables spelling correction of first names. Default ofOFFpreserves first name spellings; no correction allowed.GenderAggression:< Code or Name >- This option sets how aggressively the service will attempt to genderize neutral first names.1orAggressive-Aggressive name genderizing.2orNeutral- Default. Neutral name genderizing.3orConservative- Conservative name genderizing.
GenderPopulation:< Code or Name >- This option sets the gender balance of the source data, predominantly male, predominantly female, or neutral.1orMale- Bias towards Male.2orMixed- Default. No bias towards either gender.3orFemale- Bias towards Female.
NameHint:< Code or Name >- This option sets the most likely format of the FullName input string. This helps the service in cases where the order and formatting of the FullName input string are unclear.1orDefinitelyFull- Name will always be treated as normal name order regardless of formatting or punctuation.4orVarying- Default. Name will be treated as normal name order unless formatting or punctuation indicates otherwise.7orDefinitelyInverse- Name will always be treated as inverse name order regardless of formatting or punctuation.
Options - Pass in options you want to set for the request.
List options in the following format, with multiple options delimited with a comma ,.
For example: OptionName:Parameter,OptionName:Parameter.
Consent:< No | Yes >- This option is for data sources that require consent to be given - acknowledging that consent is given to allow the data to be verified by external data sources. Default ofNoindicates that no consent was given.
Phone Options - To be set when a phone number is being validated during the Check action.
List options in the following format, with multiple options delimited with a comma ,.
For example: OptionName:Parameter,OptionName:Parameter.
CallerID:< True | False >- US and Canada Only. Default ofFalseturnsCallerIDoff.DefaultCallingCode:< [Country Calling Code] >- This is used when the country could not be detected from the phone number or country input. The default of a blank field will check the sequence of digits found after the leading +.TimeToWait:< #[1 - 30] >- TimeToWait allows you to select how long (in seconds) that you would like our Cloud API to wait on a single request before it times out. Select a smaller number if time is of essence, or longer if you would prefer more accurate results. Default set to2.VerifyPhone:< Express | Premium >- This sets the level of verification to be done on a phone check. Default ofExpresswill validate against a database of known phone numbers.
Privacy - This Option allows data elements to be redacted from the response. The user can submit any combination of data elements to redact, or all elements. All result codes will be returned to the client will be returned to the user.
List options in the following format, with multiple options delimited with a comma ,.
For example: Privacy:value1,value2,value3.
Privacy:< [None] | name | address | phone | email | all >- Default of[None]will return all data elements.
Account Number - The input field for account number. This should contain an IBAN or SWIFT number.
Address Line 1 - The input field for the address. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) but should not contain locality information (locality, administrative area, postal code, etc.) which have their own inputs.
Administrative Area - State, Province. The most common geographic data element.
Country of Origin - This is used to determine whether or not to include the country name as the last line in the FormattedAddress field.
Full Name - The full name to be genderized, standardized, and parsed. This will only be done if the first name and last name fields are left blank.
Locality - City, Municipality. The most common population center data element.
- Personator Identity Serverhttps://globalpersonator.melissadata.net/v1/doContactVerify
- curl
- C#
- Python
- Java
- JavaScript
- Node.js
- PHP
- Go
- Ruby
- R
- C#+Newtonsoft
- Java8+Apache
- Payload
curl -i -X GET \
'https://globalpersonator.melissadata.net/v1/doContactVerify?id={REPLACE-WITH-YOUR-LICENSE-KEY}&a1=22382+Avenida+Empresa&admarea=CA&ctry=US&full=John+Smith&loc=Rancho+Santa+Margarita&postal=92688'{ "Version": "9.4.0.1259", "TransmissionReference": "Test", "Results": "", "TransactionID": "{{Unique-Transaction-ID}}", "Name": { "Results": "NS01,NS05,NS06", "Company": "", "NamePrefix": "", "NameFirst": "John", "NameMiddle": "", "NameLast": "Smith", "NameSuffix": "", "Gender": "M", "NamePrefix2": "", "NameFirst2": "", "NameMiddle2": "", "NameLast2": "", "NameSuffix2": "", "Gender2": "" }, "Address": { "Results": "AC16,AV24,GS05", "FormattedAddress": "Melissa;22382 Avenida Empresa;Rancho Santa Margarita CA 92688-2112", "Organization": "Melissa", "AddressLine1": "22382 Avenida Empresa", "AddressLine2": "Rancho Santa Margarita CA 92688-2112", "AddressLine3": "", "AddressLine4": "", "AddressLine5": "", "AddressLine6": "", "AddressLine7": "", "AddressLine8": "", "SubPremises": "", "DoubleDependentLocality": "", "DependentLocality": "", "Locality": "Rancho Santa Margarita", "SubAdministrativeArea": "Orange", "AdministrativeArea": "CA", "PostalCode": "92688-2112", "AddressType": "S", "AddressKey": "92688211282", "SubNationalArea": "", "CountryName": "United States of America", "CountryCode": "US", "CountryISO3": "USA", "CountryNumber": "840", "CountrySubdivisionCode": "US-CA", "Thoroughfare": "Avenida Empresa", "ThoroughfarePreDirection": "", "ThoroughfareLeadingType": "", "ThoroughfareName": "Avenida Empresa", "ThoroughfareTrailingType": "", "ThoroughfarePostDirection": "", "DependentThoroughfare": "", "DependentThoroughfarePreDirection": "", "DependentThoroughfareLeadingType": "", "DependentThoroughfareName": "", "DependentThoroughfareTrailingType": "", "DependentThoroughfarePostDirection": "", "Building": "", "PremisesType": "", "PremisesNumber": "22382", "SubPremisesType": "", "SubPremisesNumber": "", "PostBox": "", "Latitude": "33.637562", "Longitude": "-117.606887" }, "Email": { "DeliverabilityConfidenceScore": "55", "Results": "ES01,ES07,ES08,ES21", "EmailAddress": "info@melissa.com", "MailboxName": "info", "DomainName": "melissa", "TopLevelDomain": "com", "TopLevelDomainName": "Commercial", "DateChecked": "9/29/2025 7:59:03 PM", "EmailAgeEstimated": "2868", "DomainAgeEstimated": "10903", "DomainExpirationDate": "2025-09-15T04:00:00", "DomainCreatedDate": "1995-09-16T04:00:00", "DomainUpdatedDate": "2024-09-15T12:31:43", "DomainEmail": "", "DomainOrganization": "", "DomainAddress1": "", "DomainLocality": "", "DomainAdministrativeArea": "", "DomainPostalCode": "", "DomainCountry": "", "DomainAvailability": "UNAVAILABLE", "DomainCountryCode": "", "DomainPrivateProxy": "", "PrivacyFlag": "N", "MXServer": "", "BreachCount": "" }, "Phone": { "Results": "PS01,PS22", "Carrier": "T-Mobile USA, Inc.", "CallerID": "", "InternationalPhoneNumber": "+18006354772", "PhoneNumber": "8006354772", "PhoneInternationalPrefix": "", "PhoneNationPrefix": "", "PhoneCountryDialingCode": "1", "PhoneNationalDestinationCode": "800", "PhoneSubscriberNumber": "6354772", "Locality": "Toll-free", "AdministrativeArea": "", "CountryName": "United States", "CountryAbbreviation": "US", "DST": "", "UTC": "", "Language": "", "Latitude": "", "Longitude": "", "TimeZoneCode": "EST", "TimeZoneName": "Eastern Time" }, "Identity": { "Results": "", "Confidence": "", "Datasources": [], "Watchlists": { … }, "WatchlistPersons": "", "NationalID": "", "DateOfBirth": "", "AccountNumber": { … }, "BusinessInformation": { … } } }
This is a string value that serves as a unique identifier for this set of records. It is returned as sent.
The License Key issued by Melissa.
The actions the service will perform on input data. For every request, a Check action is always performed on the input.
Check: Determines whether the data within a submitted record is valid, e.g. whether or not a given postal code contains the given city. It can also make limited corrections and appends to the data.Checklooks at each data point separately.Screen: Screens the provided input against various government sanctions and watchlists and returns back a list of matches. For a list of used watchlists, see Personator Identity Watchlists.Verify: After the data has been checked, identity verification is performed and result codes (KV*) are returned to indicate what pieces of input data have been matched against trusted referenced data.
Address Options - To be set when an address is being validated during the Check action.
List options in the following format, with multiple options delimited with a comma ,.
For example: OptionName:Parameter,OptionName:Parameter.
CountryOfOrigin:< ISO2, ISO3, or ISO# >- This is used to determine whether or not to include the country name as the last line in FormattedAddress.DeliveryLines:< On | Off >- This options allows you to specify if the Address Lines 1-8 should contain just the delivery address or the entire address. Default of 'Off' will return the entire address.LineSeparator:< SEMICOLON | PIPE | CR | LF | CRLF | TAB | BR >- This is the line separator used for the FormattedAddress result. Default ofSEMICOLONwill use a semicolon;.OutputScript:< NOCHANGE | LATIN | NATIVE >- This is the script type used for all applicable fields. Default ofNOCHANGEwill return the same script that is sent in.
Email Options - To be set when an email is being validated during the Check action.
List options in the following format, with multiple options delimited with a comma ,.
For example: OptionName:Parameter,OptionName:Parameter.
DomainCorrection:< On | Off >- Default ofOnactivates fuzzy email domain correction if the domain is a suspected typo.TimeToWait:< #[5 - 45] >- TimeToWait allows you to select how long (in seconds) that you would like our Cloud API to wait on a single email before it times out. Select a smaller number if time is of essence, or longer if you would prefer more accurate results. Defaults to25.VerifyMailBox:< Express | Premium >- Default ofExpressquickly validates against database of known email addresses.Premiumhas a real time check performed to determine email deliverability.
Name Options - To be set when a name is being validated during the Check action.
- Full or normal name order is: Prefix, First, Middle, Last, Suffix.
- Inverse name order is: Last, Suffix, Prefix, First, Middle.
Either the Code or Name can be used to set the action. List options in the following format, with multiple options delimited with a comma ,.
For example: OptionName:Parameter,OptionName:Parameter.
CorrectFirstName:< ON | OFF >- This option enables or disables spelling correction of first names. Default ofOFFpreserves first name spellings; no correction allowed.GenderAggression:< Code or Name >- This option sets how aggressively the service will attempt to genderize neutral first names.1orAggressive-Aggressive name genderizing.2orNeutral- Default. Neutral name genderizing.3orConservative- Conservative name genderizing.
GenderPopulation:< Code or Name >- This option sets the gender balance of the source data, predominantly male, predominantly female, or neutral.1orMale- Bias towards Male.2orMixed- Default. No bias towards either gender.3orFemale- Bias towards Female.
NameHint:< Code or Name >- This option sets the most likely format of the FullName input string. This helps the service in cases where the order and formatting of the FullName input string are unclear.1orDefinitelyFull- Name will always be treated as normal name order regardless of formatting or punctuation.4orVarying- Default. Name will be treated as normal name order unless formatting or punctuation indicates otherwise.7orDefinitelyInverse- Name will always be treated as inverse name order regardless of formatting or punctuation.
Options - Pass in options you want to set for the request.
List options in the following format, with multiple options delimited with a comma ,.
For example: OptionName:Parameter,OptionName:Parameter.
Consent:< No | Yes >- This option is for data sources that require consent to be given - acknowledging that consent is given to allow the data to be verified by external data sources. Default ofNoindicates that no consent was given.
Phone Options - To be set when a phone number is being validated during the Check action.
List options in the following format, with multiple options delimited with a comma ,.
For example: OptionName:Parameter,OptionName:Parameter.
CallerID:< True | False >- US and Canada Only. Default ofFalseturnsCallerIDoff.DefaultCallingCode:< [Country Calling Code] >- This is used when the country could not be detected from the phone number or country input. The default of a blank field will check the sequence of digits found after the leading +.TimeToWait:< #[1 - 30] >- TimeToWait allows you to select how long (in seconds) that you would like our Cloud API to wait on a single request before it times out. Select a smaller number if time is of essence, or longer if you would prefer more accurate results. Default set to2.VerifyPhone:< Express | Premium >- This sets the level of verification to be done on a phone check. Default ofExpresswill validate against a database of known phone numbers.
Privacy - This Option allows data elements to be redacted from the response. The user can submit any combination of data elements to redact, or all elements. All result codes will be returned to the client will be returned to the user.
List options in the following format, with multiple options delimited with a comma ,.
For example: Privacy:value1,value2,value3.
Privacy:< [None] | name | address | phone | email | all >- Default of[None]will return all data elements.
The input field for the address. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) but should not contain locality information (locality, administrative area, postal code, etc.) which have their own inputs.
This is used to determine whether or not to include the country name as the last line in the FormattedAddress field.
The full name to be genderized, standardized, and parsed. This will only be done if the first name and last name fields are left blank.
- Personator Identity Serverhttps://globalpersonator.melissadata.net/v1/doContactVerify
- curl
- C#
- Python
- Java
- JavaScript
- Node.js
- PHP
- Go
- Ruby
- R
- C#+Newtonsoft
- Java8+Apache
- Payload
curl -i -X POST \
https://globalpersonator.melissadata.net/v1/doContactVerify \
-H 'Content-Type: application/json' \
-d '{
"TransmissionReference": "Test",
"CustomerID": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
"Actions": "check",
"AddressOptions": "CountryOfOrigin:US,DeliveryLines:Off,LineSeparator:SEMICOLON,OutputScript:NOCHANGE",
"EmailOptions": "DomainCorrection:On,TimeToWait:10,VerifyMailBox:Express",
"NameOptions": "CorrectFirstName:OFF,GenderAggression:2,GenderPopulation:Mixed,NameHint:Varying",
"Options": "Consent:No",
"PhoneOptions": "CallerID:False,DefaultCallingCode:1,TimeToWait:5,VerifyPhone:Express",
"AddressLine1": "22382 Avenida Empresa",
"AdministrativeArea": "CA",
"Country": "US",
"Email": "info@melissa.com",
"FullName": "John Smith",
"Locality": "Rancho Santa Margarita",
"PhoneNumber": "1-800-635-4772",
"PostalCode": "92688"
}'{ "Version": "9.4.0.1259", "TransmissionReference": "Test", "Results": "", "TransactionID": "{{Unique-Transaction-ID}}", "Name": { "Results": "NS01,NS05,NS06", "Company": "", "NamePrefix": "", "NameFirst": "John", "NameMiddle": "", "NameLast": "Smith", "NameSuffix": "", "Gender": "M", "NamePrefix2": "", "NameFirst2": "", "NameMiddle2": "", "NameLast2": "", "NameSuffix2": "", "Gender2": "" }, "Address": { "Results": "AC16,AV24,GS05", "FormattedAddress": "Melissa;22382 Avenida Empresa;Rancho Santa Margarita CA 92688-2112", "Organization": "Melissa", "AddressLine1": "22382 Avenida Empresa", "AddressLine2": "Rancho Santa Margarita CA 92688-2112", "AddressLine3": "", "AddressLine4": "", "AddressLine5": "", "AddressLine6": "", "AddressLine7": "", "AddressLine8": "", "SubPremises": "", "DoubleDependentLocality": "", "DependentLocality": "", "Locality": "Rancho Santa Margarita", "SubAdministrativeArea": "Orange", "AdministrativeArea": "CA", "PostalCode": "92688-2112", "AddressType": "S", "AddressKey": "92688211282", "SubNationalArea": "", "CountryName": "United States of America", "CountryCode": "US", "CountryISO3": "USA", "CountryNumber": "840", "CountrySubdivisionCode": "US-CA", "Thoroughfare": "Avenida Empresa", "ThoroughfarePreDirection": "", "ThoroughfareLeadingType": "", "ThoroughfareName": "Avenida Empresa", "ThoroughfareTrailingType": "", "ThoroughfarePostDirection": "", "DependentThoroughfare": "", "DependentThoroughfarePreDirection": "", "DependentThoroughfareLeadingType": "", "DependentThoroughfareName": "", "DependentThoroughfareTrailingType": "", "DependentThoroughfarePostDirection": "", "Building": "", "PremisesType": "", "PremisesNumber": "22382", "SubPremisesType": "", "SubPremisesNumber": "", "PostBox": "", "Latitude": "33.637562", "Longitude": "-117.606887" }, "Email": { "DeliverabilityConfidenceScore": "55", "Results": "ES01,ES07,ES08,ES21", "EmailAddress": "info@melissa.com", "MailboxName": "info", "DomainName": "melissa", "TopLevelDomain": "com", "TopLevelDomainName": "Commercial", "DateChecked": "9/29/2025 7:59:03 PM", "EmailAgeEstimated": "2868", "DomainAgeEstimated": "10903", "DomainExpirationDate": "2025-09-15T04:00:00", "DomainCreatedDate": "1995-09-16T04:00:00", "DomainUpdatedDate": "2024-09-15T12:31:43", "DomainEmail": "", "DomainOrganization": "", "DomainAddress1": "", "DomainLocality": "", "DomainAdministrativeArea": "", "DomainPostalCode": "", "DomainCountry": "", "DomainAvailability": "UNAVAILABLE", "DomainCountryCode": "", "DomainPrivateProxy": "", "PrivacyFlag": "N", "MXServer": "", "BreachCount": "" }, "Phone": { "Results": "PS01,PS22", "Carrier": "T-Mobile USA, Inc.", "CallerID": "", "InternationalPhoneNumber": "+18006354772", "PhoneNumber": "8006354772", "PhoneInternationalPrefix": "", "PhoneNationPrefix": "", "PhoneCountryDialingCode": "1", "PhoneNationalDestinationCode": "800", "PhoneSubscriberNumber": "6354772", "Locality": "Toll-free", "AdministrativeArea": "", "CountryName": "United States", "CountryAbbreviation": "US", "DST": "", "UTC": "", "Language": "", "Latitude": "", "Longitude": "", "TimeZoneCode": "EST", "TimeZoneName": "Eastern Time" }, "Identity": { "Results": "", "Confidence": "", "Datasources": [], "Watchlists": { … }, "WatchlistPersons": "", "NationalID": "", "DateOfBirth": "", "AccountNumber": { … }, "BusinessInformation": { … } } }