Property Market Event History
GEThttps://property-api.k8s.outra.co.uk/api/v2/market-events/property-history
API keyJSON
Get market event history for a property from the consolidated market-events dataset. Returns historical listings (for sale, for rent), price changes, status changes and agent information — ordered by event_date descending and limited to the 100 most recent events per property.
Purpose
- Complete market footprint — how a property has listed, priced and moved over time.
- Transaction & listing transparency — listing, delisting and price-change events with transaction type.
- Agent attribution — the agent branch handling each listing.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
uprn | integer | Required | Property UPRN. Positive integer, maximum 12 digits. Minimum 1, maximum 999999999999. |
curl 'https://property-api.k8s.outra.co.uk/api/v2/market-events/property-history?uprn=100023336956' \
-H 'accept: application/json' \
-H 'Authorization: Api-Key {api_key}'Status codes
| Code | Description |
|---|---|
200 | Event history retrieved successfully |
401 | Authentication failed or API key invalid |
404 | Property event history not found |
422 | Request validation failed |
429 | Rate limit exceeded |
Most errors return a detail message. This endpoint's 404, however, returns the legacy envelope:
{ "success": false, "error": "Property event history not found", "version": "2.0" }Field reference
Event fieldsMARKET EVENTS
outra_id
Outra internal event ID.
uprn
Property UPRN.
event_date
Date the event occurred (most recent first).
event_type
Type of market event (listed, delisted, price_change, etc.).
transaction_type
Type of transaction (sale, rental, etc.).
agent_branch
Estate agent branch handling the listing.
price
Listed price or transaction amount.
Typical use cases
Property timeline views
Visualise the full sequence of market activity in dashboards.
Pricing analysis
Understand historical price movements and listing behaviour.
Agent activity monitoring
Track agent and branch involvement over time.