Property-Market Products

Property-market queries select one supported England/Wales local authority and one relevant segment. The API groups related measures into seven datasets; it does not expose ten separate product endpoints.

Reading these figures in a Local Authority Snapshot? The Automated Research Reports guide explains the report's sections, charts and statistical labels without requiring API knowledge.

All use GET /v1/markets/series with monthly date filters. Common optional parameters are from, to, metrics, release_id and page_size; continuation uses cursor. See Query Parameters for allowed selectors and Dates for window semantics.

The intended scope is ordinary residential property. Estimates and recorded summaries have different coverage, and not every LAD/segment supports every measure. An area appearing in /areas is not blanket confirmation of every product.

Market Activity

dataset=market_activity combines Residential Sales Activity and Estimated Price per Square Metre.

Required: dataset, area, property_type. Types: detached, semi_detached, terraced, flat. combined is not accepted.

GET /v1/markets/series?dataset=market_activity&area=E08000025&property_type=flat

The first five are the default response. To include the optional sixth, list every desired metric in metrics; this selector replaces the default selection rather than adding to it.

Window: 12 months. Core reporting endpoint: T-3. Counts, turnover and shares are recorded/revisable; price per square metre is estimated from linked usable area evidence and statistical estimation. It is not the literal median of every sale, nor the median asking price.

Nominal turnover is not an inflation-adjusted value, an estimate of all housing stock, or a measure of mortgage lending. GBP/km2 uses land area; GBP/m2 uses property floor area. Do not substitute one for the other.

Transactions without usable floor-area evidence can still contribute to sales counts and turnover. Consequently, sales can be available while the price-per-square-metre estimate is unavailable. Counts do not imply an equally large area-evidence sample.

Sales by National Price Band

dataset=price_bands.

Required: dataset, area, price_band (1-5). Do not send property_type.

GET /v1/markets/series?dataset=price_bands&area=E08000025&price_band=3&from=2026-06&to=2026-06

Window: 12 months. Core endpoint: T-3. Basis: recorded/revisable.

Five bands are defined by the 20th, 40th, 60th and 80th percentiles of eligible transaction prices across England and Wales for the same rolling window. They are national transaction-price bands, not local quintiles, fixed cash brackets or fifths of all existing housing stock.

Band 1 is the lowest national group and band 5 the highest. A LAD need not have 20% of its transactions in each band. Price ties can also prevent exactly equal national counts.

Every observation supplies its actual GBP boundaries. The lower boundary is inclusive and the upper boundary exclusive. A sale exactly on a threshold belongs to the higher band. A null outer boundary means no band boundary on that side, not zero and not exemption from the dataset's eligible residential scope.

Use period-specific boundaries in charts and tooltips: the same band number can represent different cash prices over time. Where no sales exist in a local band, counts may be zero while house/flat percentages are null because there is no denominator.

Rental Market

dataset=rental_market groups Estimated Monthly Rent, Estimated Property Values and Estimated Gross Rental Yield.

Required: dataset, area, property_type, bedroom_group.

GET /v1/markets/series?dataset=rental_market&area=E08000025&property_type=flat&bedroom_group=2

All three are estimates. The rental intersections combine rental evidence with area/type/bedroom information; they are not direct observations of every home at the exact intersection. Bedroom groups are product segments, not proof of an exactly observed room layout for every contributing property.

Gross yield is 100 × 12 × monthly rent / property value. It is a ratio of two segment estimates, not the mean of individual landlords' achieved yields. It excludes finance costs, taxes, fees, voids, repairs, management and service charges. It is not net yield or total investment return.

For illustration only, rent of GBP1,000 per month and a capital estimate of GBP240,000 imply a 5% gross yield before costs. That identity does not establish either input's accuracy for a particular property.

Capital uses the core T-3 endpoint. Rent and yield can use a newer accepted rental month. Each metric retains its own date and coverage; do not force them into one common date. Rent can remain available where capital and yield are withheld. There is no separate studio-only or five-bedroom feed.

New-Build Price Differential

dataset=new_build_price_differential.

Required: dataset, area, property_type; one of the four types, not combined.

GET /v1/markets/series?dataset=new_build_price_differential&area=E08000025&property_type=detached

Metrics: price_differential_pct, lower_estimate_pct, upper_estimate_pct, all in percent. Window: 36 months. Core endpoint: T-3. Basis: estimated.

The estimate compares new-build and resale pricing after adjustments for differences in the evidence. It is not a raw difference between two unadjusted area averages. A value of 8 means an estimated 8% differential, not eight percentage points of annual appreciation.

The differential can be negative. It is not a guaranteed premium, an uplift to apply mechanically to an individual home or a forecast of what a developer will achieve. Coverage is more selective than the ordinary trading grid.

Bounds are labelled modelled_uncertainty. Do not describe them as externally calibrated prediction intervals, a confidence score or a guarantee that a property's sale price lies between them. They describe uncertainty around the differential estimate, not an absolute property-value range.

The product's supported history is assessed from 2015, but each admitted series can start later. Use returned coverage rather than promising an identical first date in every area.

Within an admitted series, estimates more than five years older than the release month may remain available with a historical_evidence_below_current_threshold warning when evidence is weaker or uncertainty wider than the current publication criteria. This preserves historical continuity without implying equal evidence quality across all months. The estimate and its bounds are not adjusted to remove the warning. Numerical validity checks still apply, and this allowance does not apply to recent observations.

Estimated New-Build Deliveries

dataset=new_build_deliveries.

Required: dataset, area, property_type; the four types or combined.

GET /v1/markets/series?dataset=new_build_deliveries&area=E08000025&property_type=combined

Metric: deliveries_count, in homes. Window: 12 months. Core endpoint: T-3. Basis: estimated.

This estimates homes entering completed or certified new-dwelling stock. Administrative evidence can differ from the timing of physical completion, occupation or sale. The measure is not a verified completions census, planning-permission count, construction-start count or total pipeline capacity.

Deliveries can exist without a recorded sale. Do not assume the delivery population and the trading population are identical or use their ratio as an undocumented absorption measure.

New-Build Share of Sales

dataset=new_build_sales_share.

Required: dataset, area, property_type; the four types or combined.

GET /v1/markets/series?dataset=new_build_sales_share&area=E08000025&property_type=flat

Window: 12 months. Core endpoint: T-3. Basis: recorded/revisable. The combined result uses combined counts rather than averaging the type percentages.

This is sales composition, not uptake. It does not mean that this proportion of newly delivered homes sold, sold within 12 months, or remains unsold. A zero denominator yields a null percentage with zero_denominator, while the counts remain meaningful.

Estimated Deliveries by Development Size

dataset=development_deliveries.

Required: dataset, area, property_type, development_size. Combined type is not supported.

GET /v1/markets/series?dataset=development_deliveries&area=E08000025&property_type=flat&development_size=large

These categories describe the observed cluster, not verified planning-site boundaries or eventual scheme capacity. One observed home does not prove a self-build or a one-home development. Partially delivered schemes can change category as evidence accumulates.

Window: 12-month deliveries; cluster size reflects evidence through the endpoint. Core endpoint: T-3. Basis: estimated.

The response separately identifies total, classified and unclassified deliveries and classification coverage. Shares against all deliveries need not sum to 100% across the four classified categories. The classified-only shares use a different denominator. unclassified is not a fifth query selector; its count is disclosed as coverage metadata. Missing classification must not be presented as single-home supply.