> ## Documentation Index
> Fetch the complete documentation index at: https://developers.investorlift.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The History event object

> One typed change on a parcel, the weekly file that showed it, and the domain's columns before and after.

One change on one parcel, from the week-over-week comparison of the deliveries.
[`GET /v1/properties/{property_id}/history`](/api-reference/endpoints/properties-history) returns it, and
[`GET /v1/markets/{market}/changes`](/api-reference/endpoints/markets-changes) counts it across a ZIP.

## Domain and kind

`domain` is the part of the file that changed. `kind` is what the change was.

| `domain`         | `kind` values                                                             |
| ---------------- | ------------------------------------------------------------------------- |
| `ownership`      | `owner_change`, `first_seen`, `deleted`, `removed`                        |
| `mailing`        | `mailing_change`                                                          |
| `occupancy`      | `occupancy_change`                                                        |
| `vacancy`        | `vacancy`, `vacancy_cleared`, `mailing_vacancy`                           |
| `classification` | `classification_change`                                                   |
| `structure`      | `structure_change`                                                        |
| `assessment`     | `assessment`                                                              |
| `tax`            | `tax_delinquent`, `tax_cured`, `tax_change`                               |
| `sale`           | `sale`                                                                    |
| `deed`           | `deed`                                                                    |
| `listing`        | `listed`, `relist`, `price_cut`, `price_rise`, `sold`, `delist`, `status` |
| `owner_profile`  | `portfolio_change`                                                        |
| `valuation`      | `avm`                                                                     |
| `financing`      | `new_mortgage`, `lien_released`, `involuntary_lien`, `financing_change`   |

`first_seen` means the parcel entered the record. It is not a change to the parcel. `deleted` and `removed` mean the
parcel left the record.

## The week is an observation, not a date

`week` is the weekly file that showed the change. It is the only date the replay can give truthfully. A change between
two files occurred at some point between them.

`span_weeks` is the number of weeks since the previous file that showed the parcel. In a normal week it is 1. Across a
gap in the deliveries, the replay dates the event to the **first file after the gap**. It sets `span_weeks` to the
length of that gap. The replay invents no intermediate week.

An `owner_change` with `span_weeks: 4` tells you the owner changed at some point in those four weeks. The deed in
`deed` usually narrows it, because the recording date is a real date.

## before, after and deed

* `before` and `after` are the domain's own columns, with the keys the delivery uses. So the keys differ between
  domains. Compare the two to see what changed.
* `before` is null on a first sighting, and `after` is null on a deletion.
* `deed` has a value only on an `owner_change`. It carries what the deed of the same week showed: the document type,
  the sale price and the recording date. It is null on every other kind.

## Dated domains

`valuation` and `financing` events come from the dated snapshot, so a response that carries them also carries
`meta.dated[]`. Both stop at the slice date the market's coverage row names
(`meta.coverage[].parcel.financing.as_of`). After that date the deliveries no longer carry the datasets. So the
silence comes from the delivery, not from the parcel. The `coverage` block of the history response says so per
domain. See
[dated data](/guides/concepts/dated-data).


## Related topics

- [The Listing cycle object](/api-reference/objects/listing-cycle.md)
- [Read a parcel's history](/api-reference/endpoints/properties-history.md)
- [The Investor object](/api-reference/objects/investor.md)
- [Read what changed on a parcel, week by week](/api-reference/properties/read-what-changed-on-a-parcel-week-by-week.md)
- [The Investorlift listing object](/api-reference/objects/wholesale-listing.md)