---
title: "Search for a contact"
method: GET
path: "/docontactSearch"
tags: ["Contact Search"]
---

# Search for a contact

`GET /docontactSearch`

## Request

- Base URL: `https://search.melissadata.net/V5/WEB/contactsearch`
- URL: `https://search.melissadata.net/V5/WEB/contactsearch/docontactSearch`
- Auth: none required

The service requires at least one of the following input combinations:

**Set A** - `a1`, `loc`, `adminarea`, `postal`

**Set B** - `phone`

**Set C** - `full` / `last` / `anyname` / `comp`, `adminarea`

**Set C** - `full` / `last` / `anyname` / `comp`, `postal`

## Query parameters

- `id` string, required
- `matchlevel` string
- `maxrecords` string
- `t` string
- `a1` string
- `adminarea` string, required
- `ctry` string
- `loc` string
- `phone` string
- `postal` string
- `premnum` string
- `subpremnum` string
- `tname` string
- `postdir` string
- `predir` string
- `trailingtype` string
- `anyname` string, required
- `comp` string
- `first` string
- `full` string
- `last` string
- `subuser` string

## Headers

- `Accept` 'application/json' | '*/*', required
- `Content-Type` 'application/json', required

## 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)