Accessing Historical Listings for an Address

When working with real estate listings, understanding the historical context of a property can be crucial. At Repliers, our API provides comprehensive access to both current and historical listing data. Here’s how you can access this information through our API.

History For A Specific Listing or MLS Number

When you make a request for a specific listing or MLS number, for example https://api.repliers.io/listings/123456789, the listing response includes a "history" object within the listing data itself. This object contains an array of historical transactions for the address. Here's an example of what the history object might look like for a listing:

{
    "history": [
        {
            "mlsNumber": "123455677XX",
            "type": "Sale",
            "listPrice": "499900.00",
            "listDate": "2024-05-11T00:00:00.000Z",
            "lastStatus": "Terminated",
            "office": {
                "brokerageName": "RE/MAX REALTY PEOPLE INC."
            },
            "timestamps": {
                "idxUpdated": "2024-06-09T16:57:49.000Z",
                "listingUpdated": "2024-06-09T16:57:49.000Z",
                "photosUpdated": "2024-05-11T18:02:32.000Z",
                "listingEntryDate": "2024-05-11T00:00:00.000Z",
                "expiryDate": "2024-12-31T00:00:00.000Z"
            }
        }
    ]
}

This object is built dynamically when the listing is requested, so it will always contain all of the MLS history for the listing's address.

History For A Specific Address

You can also lookup the history of an address. Depending on your workflow, this may be more efficient than looking up history for a specific listing or MLS number.

Example Request

Here is an example of how you can make a request using the address history endpoint:

https://api.repliers.io/listings/history?streetNumber=101&streetName=Dalmations&streetSuffix=Cres&city=New York&zip=90000

The response is built dynamically when the address is queried, so it will always contain all of the address history for the provided address.

History When Searching For Listings

When you search for listings, you can choose to include historical data for all properties in your search results simultaneously. However, there's an important limitation to be aware of:

History Completeness for Off-Market Listings

For older listings that are no longer active on the market, the historical data may be incomplete. Here's why:

Active listings: History gets updated regularly while the property remains on the market
Off-market listings: Once a listing goes off-market, its history stops being updated in the system
Impact: Older, off-market properties may show gaps in their historical data or appear to have less comprehensive records

What This Means for You

When reviewing historical data in your search results, keep in mind that:

Recent and active listings will have the most complete history
Older, sold, or expired listings may have incomplete historical records
The missing history doesn't mean the data never existed—it simply wasn't captured after the listing went off-market

For more information on the address history lookup endpoint please refer to our API documentation.

Updated on: 03/06/2025