Search for a contact

Request

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

idstringrequired

Required. The License Key issued by Melissa.

Example:id=REPLACE-WITH-YOUR-LICENSE-KEY

matchlevelstring

0-100. The weighted percentage of how close the query matches the returned record. Anything less than 80% is questionable.

Example:matchlevel=10

maxrecordsstring

The maximum number of records to return.

Example:maxrecords=10

tstring

This is a string value that serves as a unique identifier for this set of records. It is returned as sent.

Example:t=Test

a1string

The input field for the address. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.)

Example:a1=22382+Avenida+Empresa

adminareastringrequired

State, Province. The most common geographic data element.

Example:adminarea=CA

ctrystring

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.

locstring

City, Municipality. The most common population center data element.

Example:loc=RSM

phonestring

The phone number of the individual or company.

postalstring

ZIP, Postcode. The complete postal code for a particular delivery point.

Example:postal=92688

premnumstring

Street Number. Alphanumeric indicator for the most common street or block data element.

subpremnumstring

Suite Number. The Sub premises alphanumeric indicator for the most common street or block data element.

tnamestring

Street Name. Name indicator for the most common street or block data element.

postdirstring

Street Post Direction. The postfix directional for the most common street or block data element.

predirstring

Street PreDirection. The prefix directional for the most common street or block data element.

trailingtypestring

Street Suffix. The trailing thoroughfare type indicator for the most common street or block data element.

anynamestringrequired

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.

Example:anyname=Melissa+Data

compstring

The name of a business or corporation.

firststring

The first name of an individual.

fullstring

The full name of an individual. Inverse name order is also accepted (Smith Tim vs. Tim Smith).

laststring

The last name of an individual.

subuserstring

The Sub User ID. This is used to identify a group or users for multiple users/seats for logging purposes.

Acceptstringrequired

Format of the response.

Enum:"application/json""*/*"

Example:application/json

Content-Typestringrequired

Format of the request.

Value:"application/json"

curl -i -X GET \
  'https://search.melissadata.net/V5/WEB/contactsearch/docontactSearch?id=REPLACE-WITH-YOUR-LICENSE-KEY&adminarea=CA&anyname=Melissa%2BData' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json'

Responses

Successful response

Bodyapplication/json

TransmissionReferencestring

Serves as a unique request identifier.

Versionstring

The current service version number.

ResultCodestring

Comma delimited status, error codes, and change codes for the request.

TotalRecordsstring

Total number of records.

ResultsArray of objects, <= 100

A results array containing the returned records.

Response

{
  "TransmissionReference": "Test",
  "Version": "7.1.6.1078",
  "ResultCode": "US01",
  "TotalRecords": "1",
  "Results": {
    "MatchLevel": "85.78",
    "Address": { … },
    "CompanyName": { … },
    "Consumer": { … },
    "Phone": { … }
  }
}