Skip to content
  • Data Retriever
  • Elected Officials
  • Global Address Verification
  • Global Email
  • Global Express Entry
  • Global IP
  • Global Name
  • Global Phone
  • LeadGen - Business
  • LeadGen - Consumer
  • LeadGen - Occupant
  • LeadGen - Property
  • Melissa Releases
  • People Business Search
  • Contact Search
  • Search contacts
    post
  • Personator Consumer
  • Personator Identity
  • Personator Search
  • Property
  • Reverse GeoCoder
  • SmartMover CA
  • SmartMover US
  • SSN Name Match
  • Street Route
  • Token Server
  • US Business Coder
  • Usage

    • Search contacts

    Request

    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
    Acceptstringrequired

    Format of the response.

    Enum:"application/json""*/*"
    Example:application/json
    Content-Typestringrequired

    Format of the request.

    Value:"application/json"
    Bodyapplication/jsonrequired
    CustomerIDstringrequired

    Required. The License Key issued by Melissa.

    MatchLevelstring

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

    MaxRecordsstring

    The maximum number of records to return.

    TransmissionReferencestring

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

    AddressLine1string

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

    AdministrativeAreastring

    State, Province. The most common geographic data element.

    Countrystring

    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.

    Localitystring

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

    PhoneNumberstring

    The phone number of the individual or company.

    PostalCodestring

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

    PremiseNumberstring

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

    SubpremisesNumberstring

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

    ThoroughfareNamestring

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

    ThoroughfarePostdirectionstring

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

    ThoroughfarePredirectionstring

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

    ThoroughfareTrailingTypestring

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

    AnyNamestring

    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.

    CompanyNamestring

    The name of a business or corporation.

    FirstNamestring

    The first name of an individual.

    FullNamestring

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

    LastNamestring

    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.

    curl -i -X POST \
  https://search.melissadata.net/V5/WEB/contactsearch/docontactSearch \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "TransmissionReference": "Test",
    "CustomerID": "REPLACE-WITH-YOUR-LICENSE-KEY",
    "MaxRecords": "10",
    "MatchLevel": "10",
    "AddressLine1": "22382 Avenida Empresa",
    "Locality": "RSM",
    "AdministrativeArea": "CA",
    "PostalCode": "92688",
    "AnyName": "Melissa Data"
  }'

    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": { … }
  }
}