--- title: "Verify a consumer" method: GET path: "/doContactVerify" tags: ["Consumer Verification"] --- # Verify a consumer `GET /doContactVerify` 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](https://docs.melissa.com/cloud-api/personator-consumer/personator-consumer-faq.html#minimum-input-requirements) for more details. ## Query parameters - `act` string[], required - `cols` string - `id` unknown, required - `opt` string - `t` string - `a1` string, required - `a2` string - `ageapprox` string - `agegt` string - `agelt` string - `bday` string - `bmo` string - `byr` string - `city` string, required - `comp` string - `ctry` string - `email` string - `first` string - `format` 'json' | 'xml' - `ff` string - `full` string - `ip` string - `lastline` string - `last` string - `mak` string - `mik` string - `phone` string - `postal` string - `state` string, required ## Headers - `Accept` 'application/json' | 'application/xml' | '*/*', required - `Content-Type` 'application/json' | 'application/xml', required ## Response `200` Successful response - Response - `TotalRecords` string — Total number of records. - `TransmissionReference` string — A pass-through of the input TransmissionReference field. - `TransmissionResults` string — Lists error codes from any errors caused by the most recent request as a whole. For more information, see [Personator Consumer Result Codes](https://docs.melissa.com/cloud-api/personator-consumer/result-codes.html). - `Version` string — The current service version number. - `Records` ResponseRecord[] - `AddressExtras` string — Any extra information that does not fit in the AddressLine fields. - `AddressKey` string — Returns a unique identifier for an address. This key can be used with other current and future Melissa services. - `AddressLine1` string — Returns the address entered in the AddressLine field. If two addresses were entered and only one is valid, the valid address is returned instead. This includes the suite and private mailbox. - `AddressLine2` string — If two addresses are passed into the AddressLine field, the second address is returned here. If only one of two addresses is valid, the valid address will be returned in AddressLine1. - `City` string — Returns the city entered in the City field. - `CompanyName` string — Returns the company name. - `EmailAddress` string — Returns the email address entered in the Email field. - `MelissaAddressKey` string — Returns a unique key associated with an address. - `MelissaAddressKeyBase` string — Returns a unique key associated with a building containing multiple suites/apartments. - `NameFull` string — Returns the full name for the record. - `PhoneNumber` string — Returns the standardized phone number for the record. - `PostalCode` string — Returns the 9-digit postal code for U.S. addresses and 6-digit postal code for Canadian addresses. - `RecordID` string — Returns a unique identifier for the current record if one was sent in the request. Use this element to match a request record and the corresponding response record. - `Results` string — Returns a string value with comma delimited status, error codes, and change codes for the record. For more information, see [Personator Consumer Result Codes](https://docs.melissa.com/cloud-api/personator-consumer/result-codes.html). - `State` string — Returns the state for the record - `DateLastConfirmed` string — Returns the date this record was last seen updated from one of Personator's Data Sources. - `EstimatedHomeValue` string — The estimated value of the home, given in U.S. Dollars. - `MelissaIdentityKey` string — Returns a unique key associated with an individual. In order to retrieve the MelissaIdentityKey, the Check and Verify Actions must both be enabled: `"Actions":"Check,Verify"` - `MoveDate` string — Returns the date associated with the move address. - `Occupation` 'Physician/Dentist' | 'Healthcare' | 'Lawyer/Judge' | 'Professional/Technical' | 'Management' | 'Teacher/Educator' | 'Sales/Marketing' | 'Clerical/Service Worker' | 'Tradesmen/Laborer' | 'Farmer' | 'Student' | 'Homemaker' | 'Retired' | 'Federal Employee' | 'Military' | 'Military Retired' | 'Business Owner' | 'Religious' | 'Self Employed' | 'Financial' | 'Other' — Returns the category for the individual's occupation. - `OwnRent` 'Definite Renter' | 'Inferred Renter' | 'Inferred Owner' | 'Definite Owner' — Returns the individual's status as owner or renter of the property. - `PhoneCountryCode` string — Returns the 2 character country code for the phone number entered in the Phone field. - `PhoneCountryName` string — Returns the full country name for the phone number entered in the Phone field. - `Plus4` string — Returns the 4-digit plus4 for the input address. If this column is requested, the PostalCode field will only contain the 5-digit ZIP for U.S. addresses. - `PrivateMailBox` string — Returns the private mail box number for the address in the AddressLine field, if any. Private mailboxes are private mail boxes in commercial mail receiving agencies, like a UPS Store. If requested, the Private mailbox will be populated in this field instead of the Address field. - `RecordExtras` string — Currently non-functional. This is reserved as a placeholder for future functionality. - `Reserved` string — Currently non-functional. This is reserved as a placeholder for future output fields to be added in Personator. - `Suite` string — Returns the suite for the address in the AddressLine field, if any. If requested, the suite will be populated in this field instead of the Address field. - `AddressTypeCode` string — Returns a code for the address type in the AddressLine field. For more information, see [Personator Consumer Result Codes](https://docs.melissa.com/cloud-api/personator-consumer/result-codes.html). - `CarrierRoute` string — Returns a 4-character code defining the carrier route for this record. - `CityAbbreviation` string — Returns an abbreviation for the city entered in the City field, if any. - `CountryCode` string — Returns the country code for the country in the Country field. - `CountryName` string — Returns the country name for the record. - `DeliveryIndicator` 'B' | 'R' | 'U' — Returns an indicator of whether an address is a business address or residential address. - `DeliveryPointCheckDigit` string — Returns a string value containing the 1-digit delivery point check digit. - `DeliveryPointCode` string — Returns a string value containing the 2-digit delivery point code. - `StateName` string — Returns the full name of the state entered in the State field. - `UrbanizationName` string — Returns the urbanization name for the address entered in the AddressLine field. Usually only used if the address is in Puerto Rico. - `UTC` string — Returns the time zone of the requested record. All Melissa products express time zones in UTC (Coordinated Universal Time). - `CBSACode` string — Census Bureau's Core Based Statistical Area (CBSA). Returns the 5-digit code for the CBSA associated with the requested record. - `CBSADivisionCode` string — Returns the code for a division associated with the requested record, if any. - `CBSADivisionLevel` string — Returns whether the CBSA division, if any, is metropolitan or micropolitan. - `CBSADivisionTitle` string — Returns the title for the CBSA division, if any. - `CBSALevel` string — Returns whether the CBSA is metropolitan or micropolitan. - `CBSATitle` string — Returns the title for the CBSA. - `CensusBlock` string — Returns a 4-digit string containing the census block number associated with the requested record. - `CensusTract` string — Returns a 4-to 6-digit string containing the census tract number associated with the requested record. Census tracts are small subdivisions of a county. - `CongressionalDistrict` string — Returns the 2-digit congressional district that the requested record belongs to. - `CountyFIPS` string — Returns the FIPS code for the county in the County field. - `CountyName` string — Returns the county name. - `PlaceCode` string — When ZIP codes overlap, the City field will always return the city that covers most of the ZIP area. If the address is located outside of that city but within the ZIP Code, PlaceCode/PlaceName will refer to that area. - `PlaceName` string — When ZIP codes overlap, the City field will always return the city that covers most of the ZIP area. If the address is located outside of that city but within the ZIP Code, PlaceCode/PlaceName will refer to that area. - `CensusKey` string — Returns a 15 digit string containing the concatenated County FIPS, Census Tract and Census Block. - `CountySubdivisionCode` string — Returns a 5 digit string representing the County Subdivision Code for the requested record. - `CountySubdivisionName` string — Returns the County Subdivision Name for the requested record. - `ElementarySchoolDistrictCode` string — Returns a 5 digit string representing the Elementary School District Code for the requested record. - `ElementarySchoolDistrictName` string — Returns the Elementary School District Name for the requested record. - `SecondarySchoolDistrictCode` string — Returns a 5 digit string representing the Secondary School District Code for the requested record. - `SecondarySchoolDistrictName` string — Returns the Secondary School District Name for the requested record. - `StateDistrictLower` string — Returns a 3 digit string representing the Lower State District Code for the requested record. - `StateDistrictUpper` string — Returns a 3 digit string representing the Upper State District Code for the requested record. - `UnifiedSchoolDistrictCode` string — Returns a 5 digit string representing the Unified School District Code for the requested record. - `UnifiedSchoolDistrictName` string — Returns the Secondary Unified District Name for the requested record. - `Latitude` string — Returns the geocoded latitude for the address entered in the AddressLine field. - `Longitude` string — Returns the geocoded longitude for the address entered in the AddressLine field. - `ChildrenAgeRange` 'Blank' | '0-2' | '3-5' | '6-10' | '11-15' | '16-17' — Returns the age range of children present in the household. - `CreditCardUser` string — Returns whether the user has a credit card or not. - `DateOfBirth` string — Returns the date of birth in the format `YYYYMM`. Accuracy is only to the month. - `DateOfDeath` string — Returns the full date of death in the format `YYYYMMDD`. - `DemographicsGender` 'Unknown' | 'Male' | 'Female' | 'Neutral' — Returns gender based on demographics data. - `DemographicsResults` string — If any demographics are enabled, Demographics Results will return a comma delimited string containing all the results of the demographics combined. - `Education` 'Blank' | 'High School' | 'College' | 'Graduate School' | 'Vocational/Technical School' — Returns the highest level of education completed by an individual. - `EthnicCode` 'Afghan' | 'African-American' | 'Albanian' | 'Aleutian' | 'Algerian' | 'American Indian' | 'Arabian' | 'Armenian' | 'Ashanti' | 'Australian' | 'Austrian' | 'Azerbaijani' | 'Bahrain' | 'Bangladesh' | 'Basotho' | 'Basque' | 'Belgian' | 'Belorussian' | 'Beninese' | 'Bhutanese' | 'Black African' | 'Bosnian Muslim' | 'Botswanian' | 'Bulgarian' | 'Burkina Faso' | 'Burundian' | 'Cameroonian' | 'Caribbean African American' | 'Central African Republic' | 'Chadian' | 'Chechnyan' | 'Chinese' | 'Comoros' | 'Congolese' | 'Croatian' | 'Czech' | 'Danish' | 'Djiboutian' | 'Dutch' | 'Egyptian' | 'English' | 'Equatorial Guinea' | 'Estonian' | 'Ethiopian' | 'Fiji' | 'Finnish' | 'French' | 'Gabon' | 'Gambian' | 'Georgian' | 'German' | 'Ghanaian' | 'Greek' | 'Guinea Bissau' | 'Guinean' | 'Guyanese' | 'Hausa' | 'Hawaiian' | 'Icelandic' | 'Indian' | 'Indonesian' | 'Iraqi' | 'Irish' | 'Italian' | 'Ivorian' | 'Japanese' | 'Jewish' | 'Kampuchean/Khmer(Cambodian)' | 'Kazakhstan' | 'Kenyan' | 'Kirghizia' | 'Korean' | 'Kurdish' | 'Kuwaiti' | 'Kyrgyzstani' | 'Laotian' | 'Latvian' | 'Lesotho' | 'Liberian' | 'Libyan' | 'Liechtenstein' | 'Lithuanian' | 'Luxembourgian' | 'Macedonia' | 'Madagascan' | 'Malawian' | 'Malaysian' | 'Maldivian & Tongan' | 'Malian' | 'Maltese' | 'Manx' | 'Mauritanian' | 'Moldovan' | 'Mongolian' | 'Moroccan' | 'Mozambican' | 'Multi-Ethnic' | 'Myanmar (Burmese)' | 'Namibian' | 'Nepalese' | 'New Zealand' | 'Niger' | 'Nigerian' | 'Norwegian' | 'Other Oriental' | 'Pakistani' | 'Papua New Guinean' | 'Persian' | 'Philippine' | 'Pili' | 'Polish' | 'Portuguese' | 'Qatari' | 'Romanian' | 'Russian' | 'Saudi' | 'Scottish' | 'Senegalese' | 'Serbian' | 'Seychelles' | 'Sierre Leone' | 'Sinhalese (Sri-Lankan)' | 'Slovakian' | 'Slovenian' | 'Somalian' | 'South African' | 'Spanish' | 'Sudanese' | 'Surinamese' | 'Swedish' | 'Swiss' | 'Syrian' | 'Tajik' | 'Tajikistan' | 'Tanzanian' | 'Telugan' | 'Thai' | 'Tibetan' | 'Togolese' | 'Tonga' | 'Tunisian' | 'Turkish' | 'Turkmenistan' | 'Ugandan' | 'Ukrainian' | 'Uzbekistan' | 'Vanuatuan' | 'Vietnamese' | 'Welsh' | 'Western Samoan' | 'Xhosa' | 'Yemeni' | 'Zairean' | 'Zambian' | 'Zimbabwean' | 'Zulu' — Returns an individual's specific ethnicity. - `EthnicGroup` 'All African American Ethnic Groups' | 'Central & Southwest Asian' | 'Eastern European' | 'Far Eastern' | 'Hispanic' | 'Jewish' | 'Mediterranean' | 'Middle Eastern' | 'Native American' | 'Other' | 'Polynesian' | 'Scandinavian' | 'Southeast Asian' | 'Western European' — Returns the grouped category for a person's ethnicity. This is a more generalized grouping compared to Ethnic Codes. - `HouseholdIncome` 'ID01' | 'ID02' | 'ID03' | 'ID04' | 'ID05' | 'ID06' | 'ID07' | 'ID08' | 'ID09' | 'ID10' | 'ID11' — Returns the range of the household's income. - `HouseholdSize` 'Blank' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' — Returns the number of occupants in the household. - `LengthOfResidence` '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' — Returns the range of the individual's length of residency in their current address. - `MaritalStatus` 'Unknown' | 'Definitely Single' | 'Inferred Single' | 'Inferred Married' | 'Definitely Married' — Returns the individual's marital status. - `MedianHouseholdIncome` '$0-$9,999' | '$10,000-$19,999' | '$20,000-$29,999' | '$30,000-$39,999' | '$40,000-$49,999' | '$50,000-$59,999' | '$60,000-$69,999' | '$70,000-$79,999' | '$80,000-$89,999' | '$90,000-$99,999' | '$100,000-$124,999' | '$125,000-$149,999' | '$150,000-$199,999' | '$200,000-$249,999' | '$250,000' — Returns the estimated median income for the area, based on the corresponding census block groups. - `PoliticalParty` 'Blank' | 'No Party' | 'Republican' | 'Democrat' | 'Independent' — Returns an individual's political affiliation. - `PresenceOfChildren` 'Unknown' | 'No Children Present' | 'Children Present' — Returns the presence of children in the household. - `PresenceOfSenior` 'Blank' | 'Yes' | 'No' — Returns the presence of senior/s in the household that are 55 and above. - `DistanceAddressToIP` string — This is the distance in miles between the latitude and longitude of the physical location of the IP Address and the latitude and longitude of the input Address. - `IPAddress` string — The IP address being looked up. - `IPCity` string — The city where the IP address is located. - `IPConnectionSpeed` 'dialup' | 'cable' | 'mobile' — The connection speed associated with this IP address. - `IPConnectionType` 'dialup' | 'wired' | 'wifi' | 'mobile' | 'satellite' — The type of connection used by this IP address. - `IPContinent` string — The continent where the IP address is located. - `IPCountryAbbreviation` string — The ISO 3166-1 alpha-2 country code of the country where the IP address is located. - `IPCountryName` string — The full name of the country where the IP address is located. - `IPDomainName` string — The domain name associated with this IP address. - `IPISPName` string — The name of the Internet Service Provider associated with the IP Address. - `IPLatitude` string — The latitude for the IP address. This usually points to the IP Address's postal code. - `IPLongitude` string — The longitude for the IP address. This usually points to the IP Address's postal code. - `IPPostalCode` string — The postal code where the IP Address is located. - `IPProxyDescription` 'Tor-exit' | 'Tor-relay' | 'AOL' | 'Cloud' | 'DNS' | 'VPN' | 'Web-Browser' — Additional Details for the Proxy Type returned. - `IPProxyType` 'Blank' | 'Anonymous' | 'Transparent' | 'Hosting' | 'Corporate' | 'Public' | 'Edu' | 'AOL' — The type of proxy for an IP Address. - `IPRegion` string — The region where the IP address is located, specific meaning varies from country to country. For IPs in the US this field returns the state that the IP is located within. - `IPUTC` string — The GMT offset for the area where the IP address is located. - `Gender` string — Returns a gender for the name in the FullName field. - `Gender2` string — Only used if 2 names are in the FullName field. Returns a gender for the second name in the FullName field. - `NameFirst` string — Returns the first name in the FullName field. - `NameFirst2` string — Only used if 2 names are in the FullName field. Returns the second name in the FullName field. - `NameLast` string — Returns the last name in the FullName field. - `NameLast2` string — Only used if 2 names are in the FullName field. Returns a last name for the second name in the FullName field. - `NameMiddle` string — Returns a middle name for the name in the FullName field. - `NameMiddle2` string — Only used if 2 names are in the FullName field. Returns a middle name for the second name in the FullName field. - `NamePrefix` string — Returns a prefix for the name in the FullName field. - `NamePrefix2` string — Only used if 2 names are in the FullName field. Returns a prefix for the second name in the FullName field. - `NameSuffix` string — Returns a suffix for the name in the FullName field. - `NameSuffix2` string — Only used if 2 names are in the FullName field. Returns a suffix for the second name in the FullName field. - `Salutation` string — Returns a salutation for the name in the FullName field. - `AddressDeliveryInstallation` string — Canada Only. Returns the parsed delivery installation for the address entered in the AddressLine field. - `AddressHouseNumber` string — Returns the parsed house number for the address entered in the AddressLine field. - `AddressLockBox` string — Canada Only. Returns the parsed lock box number for the address entered in the AddressLine field. - `AddressPostDirection` string — Returns the parsed post-direction for the address entered in the AddressLine field. - `AddressPreDirection` string — Returns the parsed pre-direction for the address entered in the AddressLine field. - `AddressPrivateMailboxName` string — Returns the parsed private mailbox name for the address entered in the AddressLine field. - `AddressPrivateMailboxRange` string — Returns the parsed private mailbox range for the address entered in the AddressLine field. - `AddressRouteService` string — Canada Only. Returns the parsed route service number for the address entered in the AddressLine field. - `AddressStreetName` string — Returns the parsed street name for the address entered in the AddressLine field. - `AddressStreetSuffix` string — Returns the parsed street suffix for the address entered in the AddressLine field. - `AddressSuiteName` string — Returns the parsed suite name for the address entered in the AddressLine field. - `AddressSuiteNumber` string — Returns the parsed suite number for the address entered in the AddressLine field. - `DomainName` string — Returns the parsed domain name for the email entered in the Email field. - `MailboxName` string — Returns the parsed mailbox name for the email entered in the Email field. - `TopLevelDomain` string — Returns the parsed top-level domain name for the email entered in the Email field. - `AreaCode` string — Returns the parsed area code for the phone number entered in the Phone field. - `NewAreaCode` string — Returns the parsed new area code for the phone number entered in the Phone field. - `PhoneExtension` string — Returns the parsed extension for the phone number entered in the Phone field. - `PhonePrefix` string — Returns the parsed prefix for the phone number entered in the Phone field. - `PhoneSuffix` string — Returns the parsed suffix for the phone number entered in the Phone field. ## Other responses - `400` — Bad Request --- [API](https://skmtc.net/melissa/apis/personator-consumer.md) · [All operations](https://skmtc.net/melissa/apis/personator-consumer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melissa/personator-consumer/versions/915977fef21f/schema)