Skip to main content
GET
Read the loaded markets and how fresh the data is
The freshness probe. One call tells you which markets the API loaded and which version of the data each serves. It also tells you the date of the last deed in each market. The call runs no query. It reads the same in-memory table that every response’s meta.coverage[] comes from.

​
Use it when

You cache. data.dataset_version is the one-line label that every response also carries in the X-Dataset-Version header (phx=1788469819,hou=1788470102). Put it in your cache key. Then a data refresh invalidates every cached answer at once. To notice the refresh, poll this route and not a data route. No other call in the API does less work, and this one costs no credits.

​
Read the response

  • data.markets[] has one entry per loaded market. Its dataset_version is a number that moves only on a rebuild of the market’s tables. data_end is the last deed date, as YYYY-MM-DD. The counties of the market each carry their own last deed date. loaded_at is the time that version went live.
  • data.data_end is the latest data_end across the markets. data.dataset_version is the comma-joined label. Both are null until the API loads the first market.
  • The response carries an ETag. Send it back as If-None-Match. If the dataset did not change, the API answers 304 with no body. So a poll every minute costs nothing.

​
Gotchas

  • The label lists the markets in the order the API loaded them, not in alphabetical order. Compare it as a whole string, or compare markets[].dataset_version per market.
  • A version moves on every rebuild, even a rebuild that changes no row you care about. It says “the data changed”, not “your answer changed”.
Coverage and freshness explains meta.coverage[], which every data response carries and which this route answers on its own. This route asks one question: did the version move? GET /v1/coverage asks what is covered where. It is the same probe with a place lookup. The Coverage pages state the answer as recorded from production.

Authorizations

​
Authorization
string
header
required

API key from the developer console (starts with zpka_). Create one at https://developers.investorlift.com/get-a-key.

Response

The loaded markets and their versions.

The loaded markets and their versions.

​
data
object
required

The loaded data: the dataset version and the last deed date of every market, and the one-line version label every response repeats.

​
meta
object
required

Response metadata: when the API produced it, which markets it covers, and how fresh they are.