Lookup homes owned by homeowners

Request

Submit a batch request to receive an array of homes owned by a homeowner based on their address (MAK).

The following are the possible minimum input requirements:

OwnerMAK
FreeForm

Headers

Acceptstringrequired

Format of the response.

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

Example:*/*

Content-Typestringrequired

Format of the request.

Enum:"application/json""application/xml"

Body

required

CustomerIdstringrequired

Required. The License Key issued by Melissa.

TransmissionReferencestring

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

FreeFormstring

Free form address for the property.

OwnerMAKstring

A proprietary unique key identifier for an address derived from Address Checking.

curl -i -X POST \
  https://property.melissadata.net/v4/WEB/LookupHomesByOwner \
  -H 'Accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
    "TransmissionReference": "Test",
    "CustomerId": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
    "OwnerMAK": "9005381555",
    "FreeForm": ""
  }'

Responses

Successful response

Body

Versionstring

The current service version number.

TransmissionReferencestring

Serves as a unique request identifier.

Resultsstring

Lists error codes from any errors caused by the most recent request as a whole. For more information, see Property Result Codes.

TotalRecordsinteger

Total number of records.

RecordsArray of objects

Response

{
  "Version": "9.4.2.1107",
  "TransmissionReference": "Test",
  "Results": "YS07",
  "TotalRecords": 2,
  "Records": [
    { … },
    { … }
  ]
}