Sales Listings by Location
Get current sales listings for a location (postcode or post town) from the market activity dataset. Returns active property listings from the last 90 days, optionally filtered by style, type, bedrooms and price, ordered by EVENT_DATE descending and limited to the 100 most recent.
Search criteria
- Location — matches against both
POSTCODEandPOST_TOWN, case-insensitive, with partial matching. - Recency — only listings with an
EVENT_DATEwithin the last 90 days. - Limit — up to 100 listings per page, most recent first.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
location | string | Required | Location to search — postcode or post town. Examples: SW1A, London, EX1 1AA, Manchester. Length 2–100. |
property_style | string | Optional | Filter by property style (e.g. End-Terrace, Detached, Semi-Detached). Max length 100. |
property_type | string | Optional | Filter by property type (e.g. House, Flat). Max length 100. |
bedrooms_min | integer | Optional | Minimum bedrooms. 0–20. |
bedrooms_max | integer | Optional | Maximum bedrooms. 0–20. |
listing_price_min | number | Optional | Minimum listing price. Minimum 0. |
listing_price_max | number | Optional | Maximum listing price. Minimum 0. |
page | integer | Optional | Page number (1-based). Default 1. Minimum 1. |
page_size | integer | Optional | Results per page (max 100). Default 100. Minimum 1, maximum 100. |
curl 'https://property-api.k8s.outra.co.uk/api/v2/market-events/sales-listings?location=SW1A&property_type=House&bedrooms_min=2&bedrooms_max=4&listing_price_min=200000&listing_price_max=500000&page=1&page_size=100' \
-H 'accept: application/json' \
-H 'Authorization: Api-Key {api_key}'Status codes
| Code | Description |
|---|---|
200 | Listings retrieved successfully |
401 | Authentication failed or API key invalid |
422 | Request validation failed |
429 | Rate limit exceeded |
Field reference
Each listing returns 16 fields: UPRN, TRANSACTION_TYPE, EVENT_TYPE, EVENT_DATE, ADDRESS_LINE_1–ADDRESS_LINE_4, POST_TOWN, POSTCODE, POSTCODE_DISTRICT, POSTCODE_SECTOR, PROPERTY_STYLE, PROPERTY_TYPE, BEDROOMS and LISTING_PRICE. The envelope adds page, page_size, count and the echoed location.
Typical use cases
Property search & discovery
Let users browse active listings in a specified location.
Area-based pricing analysis
Analyse pricing by postcode or post town.
Lead generation by geography
Identify prospective properties or sellers in targeted areas.