GET /api/v1/feed/status tells a licensed customer which weekly version of their rental listings feed is current, how big it is and what changed since last week.
HousingFeedcurl -H "Authorization: Bearer $HOUSINGFEED_KEY" https://housingfeed.com/api/v1/feed/statusRequires the key issued with your Display Feed licence. See Authentication.
{
"version": "2026-10-19",
"published_at": "2026-10-19T06:12:00Z",
"next_update_expected": "2026-10-26",
"listing_count": 12000,
"page_size": 500,
"listing_pages": 24,
"since_version": "2026-10-12",
"changes": {
"added": 900,
"changed": 1500,
"removed": 700
},
"change_pages": 7,
"changes_from": [
"2026-10-12",
"2026-10-05"
],
"versions": [
"2026-10-19",
"2026-10-12",
"2026-10-05"
]
}| Field | Meaning |
|---|---|
version | The current weekly version. A version never changes once published. |
published_at | When the version was published. |
next_update_expected | When the next weekly version is due. |
listing_count, listing_pages, page_size | Size of the full file and how it is paged. |
since_version, changes, change_pages | The previous version and the added, changed and removed counts since it. |
changes_from | Older versions you can ask changes from with since=. |
versions | Versions still readable. Older ones answer 410. |
Call this first on every sync: if version is the one you already hold, there is nothing to do.
Tell us your cities and what you are building. You get a sample in the production format and the listing count for your markets, usually within one business day.
Request a sample