---
title: "Search contacts"
method: POST
path: "/docontactSearch"
tags: ["Contact Search"]
---

# Search contacts

`POST /docontactSearch`

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.net/melissa/apis/people-business-search.md) · [All operations](https://skmtc.net/melissa/apis/people-business-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melissa/people-business-search/revisions/d6f44cf0e16b/schema)