--- title: "Lookup listings for properties" method: POST path: "/LookupListings" tags: ["Lookup Listings"] --- # Lookup listings for properties `POST /LookupListings` 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 - `Accept` 'application/json' | 'application/xml' | '*/*', required - `Content-Type` 'application/json' | 'application/xml', required ## Request body - RequestLookupListings - `Columns` string — [Columns](https://docs.melissa.com/cloud-api/property/property-reference-guide.html#property-referenceguide-lookuplistings-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`
- `CustomerId` string, required — Required. The [License Key](https://docs.melissa.com/melissa/license/license-information.html) issued by Melissa. - `Options` string — [Options](https://docs.melissa.com/cloud-api/property/property-reference-guide.html#property-referenceguide-lookuplistings-options) - Specify which options to use. List options in `:` 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. - `TotalRecords` integer — The total number of records in the request. - `TransmissionReference` string — This is a string value that serves as a unique identifier for this set of records. It is returned as sent. - `PropertyMAK` string — A proprietary unique key identifier for an address derived from Address Checking. ## Response `200` Successful response - ResponseLookupListings - `Version` string — The current service version number. - `TransmissionReference` string — Serves as a unique request identifier. - `Results` string — Lists error codes from any errors caused by the most recent request as a whole. For more information, see [Property Result Codes](https://docs.melissa.com/cloud-api/property/result-codes.html). - `TotalRecords` integer — Total number of records. - `TransactionID` string — A unique string identifier for this record. A unique transaction ID is generated for every record handled. - `Records` LookupListingsRecords[] - `ListingInfo` LookupListingsListingInfo - `CurrentListPrice` string — Price in dollar value of the subject listing property. - `InitialStatus` string — A description of the initial status of the subject listing property. - `ListingNumber` string — The multiple listing service identification number for the subject listing property. - `MaxListPrice` string — Maximum List Price for the current listing for the subject property. - `MaxListPriceDate` string — Effective date for maximum list price for the current listing for the subject property. - `MinListPrice` string — Minimum List Price for the current listing for the subject property. - `MinListPriceDate` string — Effective date for minimum list price for the current listing for the subject property. - `OriginalListingDate` string — The date the subject listing property was put on the market - as per listing record. - `RentalIndicator` string — Indicates when the current listing is a rental. - `SoldDate` string — Date that the subject listing property has been purchased. - `SoldPrice` string — Price that the subject listing property has been purchased for. - `Status` string — Description of the most current status of the subject listing property as it relates to the sales cycle (eg: Active, Contingent, Pending Lender Approval, etc.). - `StatusSubType` string — Granular description of the most current status of the subject listing property as it relates to the sales cycle (eg: Back on Market, Bumpable Buyer, Canceled, Expired, etc.). - `ListingValue` LookupListingsListingValue - `LastPriceChangeAmount` string — Price change dollar amount from the last listing for the subject property to the current dollar amount of the subject property. - `LastPriceChangeDate` string — Date the price change occurred between the last listing for the subject property and the current listing for the subject property. - `LastStatusChange` string — Status change from the last listing for the subject property to the current status of the subject property. - `LastStatusChangeDate` string — Date the status change occurred between the last listing for the subject property and the current listing for the subject property. - `LastStatusSubTypeChange` string — Status Sub Type change from the last listing for the subject property to the current status of the subject property. - `LastStatusSubTypeChangeDate` string — Date the status sub type change occurred between the last listing for the subject property and the current listing for the subject property. - `PriorPriceChangeAmount` string — Price change dollar amount from the prior listing for the subject property to the last dollar amount of the subject property. - `PriorPriceChangeDate` string — Date the price change occurred between the prior listing for the subject property and the last listing for the subject property. - `PriorStatusChange` string — Status change from the prior listing for the subject property to the last status of the subject property. - `PriorStatusChangeDate` string — Date the status change occurred between the prior listing for the subject property and the last listing for the subject property. - `PriorStatusSubTypeChange` string — Status Sub Type change from the prior listing for the subject property to the last status of the subject property. - `PriorStatusSubTypeChangeDate` string — Date the status sub type change occurred between the prior listing for the subject property and the last listing for the subject property. - `ListingAgent` LookupListingsListingAgent - `Address` string — Listing agent's address. - `BaseMAK` string — A unique key assigned to the base address of a complex with apartments or suites; tied to the listing agent's address. - `City` string — The city containing the listing agent's address. - `Email` string — Listing agent's email. - `LicenseNumber` string — Listing agent's license number. - `MAK` string — (Melissa Address Key) A unique key assigned to the address record; tied to the listing agent's address. - `NameFull` string — Listing agent's name. - `Phone` string — Listing agent's phone number. - `State` string — The state containing the listing agent's address. - `Zip` string — The postal code containing the listing agent's address. - `ListingAgentOffice` LookupListingsListingAgentOffice - `Address` string — Listing agent's office address. - `BaseMAK` string — A unique key assigned to the base address of a complex with apartments or suites; tied to the listing agent's office. - `City` string — The city containing the office address. - `Email` string — Listing agent's email. - `MAK` string — (Melissa Address Key) A unique key assigned to the address record; tied to the listing agent's office. - `Name` string — Listing agent's office name. - `Phone` string — Listing agent's phone number. - `State` string — The state containing the office address. - `Zip` string — The postal code containing the office address. - `ListingFeatures` LookupListingsListingFeatures - `Appliances` string — Description of any appliances that are included as part of the listing property (eg: Dishwasher, Refrigerator, Microwave, etc.) May contain multiple values per subject listing property. - `ElementarySchool` string — Name of the Elementary School(s) available for the subject listing property. - `HighSchool` string — Name of the High School(s) available for the subject listing property. - `LotFeatures` string — Description of the features of the lot for the subject listing property (eg: Regular Lot, Premium Lot, Sloped Lot, etc.) May contain multiple values per subject listing property. - `MiddleSchool` string — Name of the Middle School(s) available for the subject listing property. - `SchoolDistrict` string — Name of the school district for the subject listing property. ## Other responses - `400` — Bad Request ## Changes - **2026-08-07** `20335d778b27` — 1 info - endpoint added [Change history](https://skmtc.dev/melissa/apis/property/changes/LookupListings/post.md) --- [API](https://skmtc.dev/melissa/apis/property.md) · [All operations](https://skmtc.dev/melissa/apis/property/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/melissa/property/revisions/20335d778b27/schema)