Lookup listings for properties

Request

The property LookupListings endpoint returns an array of historical market listings from the recorder table when given the MelissaAddressKey.

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

Set A - PropertyMAK

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

Columnsstring

Columns - The column names or groups to be output.

Entering the column name will return the column. Specifying a group name will return all columns in the group.

Delimit multiple columns with a ,.

For example: ColumnName,ColumnName.

Columns:

GrpAll - Recommended. Indicates to the Cloud API that all fields should be returned.

[Default] - Always return in the output structure. Includes the following groups:

GrpListingInfo

GrpListingAgent - Listing agent Information

Address
BaseMAK
City
Email
LicenseNumber
MAK
NameFull
Phone
State
Zip

GrpListingAgentOffice - Listing Agent Office Information

Address
BaseMAK
City
Email
MAK
Name
Phone
State
Zip

GrpListingFeatures

Appliances
ElementarySchool
HighSchool
LotFeatures
MiddleSchool
SchoolDistrict

GrpListingInfo

CurrentListPrice
InitialStatus
ListingNumber
MaxListPrice
MaxListPriceDate
MinListPrice
MinListPriceDate
OriginalListingDate
RentalIndicator
SoldDate
SoldPrice
Status
StatusSubType

GrpListingValue

LastPriceChangeAmount
LastPriceChangeDate
LastStatusChange
LastStatusChangeDate
LastStatusSubTypeChange
LastStatusSubTypeChangeDate
PriorPriceChangeAmount
PriorPriceChangeDate
PriorStatusChange
PriorStatusChangeDate
PriorStatusSubTypeChange
PriorStatusSubTypeChangeDate

CustomerIdstringrequired

Required. The License Key issued by Melissa.

Optionsstring

Options - Specify which options to use. List options in <OptionName>:<Parameter> format. Multiple options are delimited with a ,.

For example: OptionName:Parameter,OptionName:Parameter.

Page:< Integer > - Specifies which “page” to return. Acceptable values are any integer.
RecordsPerPage:< 0 - 100 > - Default set to 1. Sets the records per “page”. Acceptable values are 0 to 100, inclusive.

TotalRecordsinteger

The total number of records in the request.

TransmissionReferencestring

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

PropertyMAKstring

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

curl -i -X POST \
  https://property.melissadata.net/v4/WEB/LookupListings \
  -H 'Accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
    "TransmissionReference": "Test",
    "CustomerId": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
    "Columns": "",
    "Options": "page:1",
    "PropertyMAK": "7749816730"
  }'

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

TransactionIDstringdeprecated

A unique string identifier for this record. A unique transaction ID is generated for every record handled.

Response

{
  "Version": "9.4.2.1120",
  "TransmissionReference": "Test",
  "Results": "YS07",
  "TotalRecords": 1,
  "Records": [
    { … }
  ]
}