> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.repliers.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](https://docs.repliers.io/reference/get-a-listing), 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](https://docs.repliers.io/reference/lookup-address-history). 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](https://docs.repliers.io/reference/getting-started-with-your-api), 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](https://docs.repliers.io/reference/lookup-address-history).

# What questions does this article answer?

* How do I retrieve historical listing data for a specific MLS® number?  
* What does the `history` object in a listing response contain?  
* How can I request history for a specific address instead of a specific listing?  
* How do I use the listings history endpoint for an address?  
* How can I include historical data in bulk when searching for listings?  
* Why might history be incomplete for older or off-market listings?  
* How should I interpret incomplete historic data in my application?