--- title: "Search contacts" method: POST path: "/docontactSearch" tags: ["Contact Search"] --- # Search contacts `POST /docontactSearch` ## Request - Base URL: `https://search.melissadata.net/V5/WEB/contactsearch` - URL: `https://search.melissadata.net/V5/WEB/contactsearch/docontactSearch` - Auth: none required Submit a batch request to search business contacts. The service requires at least one of the following input combinations: **Set A** - `addressline1`, `locality`, `administrativearea`, `postalcode` **Set B** - `phonenumber` **Set C** - `fullname` / `lastname` / `anyname` / `companyname`, `administrativearea` **Set C** - `fullname` / `lastname` / `anyname` / `companyname`, `postalcode` ## Headers - `Accept` 'application/json' | '*/*', required - `Content-Type` 'application/json', required ## Request body - ContactSearchRequest - `CustomerID` string, required: Required. The [License Key](https://docs.melissa.com/melissa/license/license-information.html) issued by Melissa. - `MatchLevel` string: 0-100. The weighted percentage of how close the query matches the returned record. Anything less than 80% is questionable. - `MaxRecords` string: The maximum number of records to return. - `TransmissionReference` string: This is a string value that serves as a unique identifier for this set of records. It is returned as sent. - `AddressLine1` string: The input field for the address. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) - `AdministrativeArea` string: State, Province. The most common geographic data element. - `Country` string: The suspected country of the input phone number as the official country name or the ISO2 code. Some territories will require a different ISO2 code than the one that is given to them. - `Locality` string: City, Municipality. The most common population center data element. - `PhoneNumber` string: The phone number of the individual or company. - `PostalCode` string: ZIP, Postcode. The complete postal code for a particular delivery point. - `PremiseNumber` string: Street Number. Alphanumeric indicator for the most common street or block data element. - `SubpremisesNumber` string: Suite Number. The Sub premises alphanumeric indicator for the most common street or block data element. - `ThoroughfareName` string: Street Name. Name indicator for the most common street or block data element. - `ThoroughfarePostdirection` string: Street Post Direction. The postfix directional for the most common street or block data element. - `ThoroughfarePredirection` string: Street PreDirection. The prefix directional for the most common street or block data element. - `ThoroughfareTrailingType` string: Street Suffix. The trailing thoroughfare type indicator for the most common street or block data element. - `AnyName` string: Either an individual's name or a company name. It's better to use the Company Name or Full Name input fields if you know for sure. - `CompanyName` string: The name of a business or corporation. - `FirstName` string: The first name of an individual. - `FullName` string: The full name of an individual. Inverse name order is also accepted (Smith Tim vs. Tim Smith). - `LastName` string: The last name of an individual. - `SubUser` string: The Sub User ID. This is used to identify a group or users for multiple users/seats for logging purposes. ## Response `200` Successful response - ContactSearchResponse - `TransmissionReference` string: Serves as a unique request identifier. - `Version` string: The current service version number. - `ResultCode` string: Comma delimited status, error codes, and change codes for the request. - `TotalRecords` string: Total number of records. - `Results` object[]: A results array containing the returned records. - `MatchLevel` string: The percentage match level of the record with the request. Ideally above 80%. - `RecordID` string: The number of the record. Always 1 for a single request, otherwise it serves as an index of the array of records. - `Address` object - `Address1` string: The standardized or corrected contents of the input address. - `DependentLocality` string: Urbanization. Smaller population center data element. Dependent on Locality. - `Locality` string: City. Most common population center data element. - `LocalityAlternates` string: Alternate names for the locality (e.g. vanity names). - `AdministrativeArea` string: State. Most common geographic data element. - `CountryCode` string: The country ISO code. - `CountryName` string: The official country name. - `Thoroughfare` string: Street. The most common street or block data element. - `ThoroughfarePreDirection` string: Street PreDirection. The prefix directional contained within the Thoroughfare field. - `ThoroughfareName` string: Street Name. The name indicator within the Thoroughfare field. - `ThoroughfareTrailingType` string: Street Suffix. The trailing thoroughfare type indicator within the Thoroughfare field. - `ThoroughfarePostDirection` string: Street Post Direction. The postfix directional contained within the Thoroughfare field. - `Premises` string: Street Number. - `PremiseType` string: Leading premise type indicator within premises field. - `PremiseNumber` string: The alphanumeric indicator within premises field. - `SubPremises` string: Suite. Alphanumeric code identifying an individual location. - `SubPremiseType` string: Suite Name. Sub premises type indicator within premises field. - `SubPremiseNumber` string: Suite Number. Sub premises number indicator within premises field. - `PostalCode` string: Zip (Plus 4). Complete postal code for a particular delivery point. In U.S. plus 4 is not required but will be appended if address is verified. - `PostalCodeSecondary` string: A secondary postal code associated with the record when available. (eg. Plus4) - `MelissaAddressKey` string: A unique key associated with an address. - `MelissaAddressKeyBase` string: A unique key associated with a building containing multiple suites/apartments. - `Consumer` object - `FullName` string: The full name of an individual associated with the record. - `FirstName` string: The first name of an individual associated with the record. - `MiddleName` string: The middle name of an individual associated with the record. - `LastName` string: The last name of an individual associated with the record. - `Suffix` string: The first suffix (such as “Jr.” or “III”) from an inputted full name. - `OtherFullNames` string: Other names associated with the record. - `MelissaIdentityKey` string: A unique key associated with the Consumer Record. - `CompanyName` object - `CompanyName` string: The company name associated with the record. - `OtherCompanyNames` string: Other company names associated with the record. - `MelissaEnterpriseKey` string: A unique key associated with the Business Record. - `Phone` object - `Phone` string: The standardized phone number. - `OtherPhones` string: Other phone numbers associated with the record. ## Other responses - `400`: Bad Request --- [API](https://skmtc.dev/melissa/apis/people-business-search.md) - [All operations](https://skmtc.dev/melissa/apis/people-business-search/llms.txt) - [OpenAPI document](https://skmtc.dev/melissa/apis/people-business-search/revisions/d6f44cf0e16b?raw)