--- title: "Lookup listings for a property" method: GET path: "/LookupListings" tags: ["Lookup Listings"] --- # Lookup listings for a property `GET /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** - `mak` ## Query parameters - `cols` string - `id` unknown, required - `format` 'json' | 'xml' - `opt` string - `t` string - `mak` string ## Headers - `Accept` 'application/json' | 'application/xml' | '*/*', required - `Content-Type` 'application/json' | 'application/xml', required ## 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 --- [API](https://skmtc.net/melissa/apis/property.md) · [All operations](https://skmtc.net/melissa/apis/property/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melissa/property/versions/20335d778b27/schema)