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

# Search for a contact

`GET /docontactSearch`

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