Our Data / Prices & Transactions / Listing Events

Listing Events

The complete transaction lifecycle for every UK property. Not just the final sale price — every event from the moment a property is listed to the day it completes, with dates and prices at each step.

Get a free API key → Endpoint docs →

Every step of the journey

Listing events are returned as a nested array on each transaction, ordered chronologically. Each event has a type, date, price, and source.

14 Maple Avenue, Bristol BS8 3AJ

Most recent transaction · Savills Bristol

property_sale_events

Added source: Home.co.uk

12 Jan 2024 · Savills Bristol

£595,000

Price Changed source: Home.co.uk

28 Feb 2024 · 47 days on market

£575,000 −3.4%

Under Offer source: Home.co.uk

15 Mar 2024 · 63 days on market

—

Sold STC source: Home.co.uk

22 Mar 2024

—

Completed source: Land Registry

28 May 2024 · 137 days total

£558,000 97.0% of asking

Events captured

137

Days to complete

−6.2%

Asking vs sold

Added

First listed on a portal

Price Changed

Asking price reduced or increased

Under Offer

Offer accepted, not yet exchanged

Sold STC

Subject to contract

Withdrawn

Removed from market without sale

Completed

Sale registered at Land Registry

Response fields

Each object in the property_sale_events[] array contains these fields.

event_type string One of: Added, Price Changed, Under Offer, Sold STC, Withdrawn, Completed

date string Event date in ISO 8601 format (YYYY-MM-DD)

price integer|null Price in pence for Added, Price Changed, and Completed events. null for status-only events

source string Data source: Home.co.uk (listing portal data) or Land Registry (completion records)

agent string|null Estate agent name, populated on Added event if available

listing_id string|null Unique listing reference for cross-referencing within the dataset, where available

Where the data comes from

Status events (Added, Price Changed, Under Offer, Sold STC, Withdrawn) come from Home.co.uk's 30-year UK listing dataset — the same data powering one of the UK's longest-running property portals. Completed events come from HM Land Registry. We match them to a single UPRN to give you the full story in one API call.

API example

GET /api/property_sales/?uprn={uprn}

curl "https://api.homedata.co.uk/api/property_sales/?uprn=100023336956" \
  -H "Authorization: Api-Key YOUR_KEY"

import requests

r = requests.get(
    "https://api.homedata.co.uk/api/property_sales/",
    params={"uprn": "100023336956"},
    headers={"Authorization": "Api-Key YOUR_KEY"},
)
events = r.json()["results"][0]["property_sale_events"]
for e in events:
    print(f"{e['date']} — {e['event_type']} at £{e['price']/100:,.0f}")

const res = await fetch(
  "https://api.homedata.co.uk/api/property_sales/?uprn=100023336956",
  { headers: { "Authorization": "Api-Key YOUR_KEY" } }
);
const { results } = await res.json();
results[0].property_sale_events.forEach(e => {
  console.log(`${e.date} — ${e.event_type} at £${(e.price/100).toLocaleString()}`);
});

property_sale_events 200 OK

"property_sale_events": [
  {
    "event_type": "Added",
    "date": "2024-01-12",
    "price": 59500000,
    "source": "Home.co.uk",
    "agent": "Savills Bristol"
  },
  {
    "event_type": "Price Changed",
    "date": "2024-02-28",
    "price": 57500000,
    "source": "Home.co.uk",
    "agent": null
  },
  {
    "event_type": "Completed",
    "date": "2024-05-28",
    "price": 55800000,
    "source": "Land Registry",
    "agent": null
  }
]

Full endpoint reference → ← Back to Prices & Transactions