New fields

Whether the building has external cladding, assessed from facade imagery. True where cladding is present or suspected, False where the facade is visible and uncladded, null where it cannot be determined. High-rise apartment buildings only; assessed per building and applied to every flat:

• premium.property.attributes.outdoor.cladding

Detail of the cladding system: coverage, indicative fire risk, primary material, the model's confidence in each, and free-text risk notes. Only present where cladding is True:

• premium.property.attributes.outdoor.cladding_details
• premium.property.attributes.outdoor.cladding_details.cladding_coverage
• premium.property.attributes.outdoor.cladding_details.cladding_fire_risk
• premium.property.attributes.outdoor.cladding_details.primary_cladding_material
• premium.property.attributes.outdoor.cladding_details.cladding_material_confidence
• premium.property.attributes.outdoor.cladding_details.fire_risk_confidence
• premium.property.attributes.outdoor.cladding_details.risk_notes

Nearest town or city centre: name, straight-line distance, and travel distance and time by walking, driving and public transport:

• surroundings.facilities.transport.nearest_city_centre

Travel distance and time by walking, driving and public transport (driving_distance, driving_time, walking_distance, walking_time, public_transport_distance, public_transport_time) for nearest education, health, shop and transport facilities. Each mode resolves to the nearest facility by that mode:

• surroundings.facilities.education.best_nearby_secondary
• surroundings.facilities.education.nearest_good_primary
• surroundings.facilities.education.nearest_nursery
• surroundings.facilities.education.nearest_primary
• surroundings.facilities.education.nearest_secondary
• surroundings.facilities.education.nearest_university
• surroundings.facilities.health.fire_station
• surroundings.facilities.health.nearest_gp
• surroundings.facilities.health.nearest_gym
• surroundings.facilities.health.nearest_hospital
• surroundings.facilities.health.nearest_pool
• surroundings.facilities.health.police_station
• surroundings.facilities.shops.nearest_cafe
• surroundings.facilities.shops.nearest_fast_food
• surroundings.facilities.shops.nearest_nightlife
• surroundings.facilities.shops.nearest_petrol_station
• surroundings.facilities.shops.nearest_post_office
• surroundings.facilities.shops.nearest_restaurant
• surroundings.facilities.transport.nearest_train_station

The same travel distance and time fields for the nearest supermarket of each major chain (aldi, asda, co_op, iceland, lidl, m_and_s, morrisons, sainsburys, tesco, waitrose):

• surroundings.facilities.shops.nearest_supermarkets

Geometry for each planning application:

• plus.property.attributes.status.planning_applications.geometry

Deprecated fields

Deprecated in favour of x_local_grid and y_local_grid:

• property.attributes.status.irish_grid_x, property.attributes.status.irish_grid_y

New feature

Address autocomplete and postcode search now support commercial, dual use, and parent shell addresses.

As part of this improvement, we have moved the endpoints to a dedicated /search path instead of /residential.

The /residential/autocomplete and /residential/postcode endpoints will remain working for backwards compatibility.

New fields

All planning applications for the property, sorted by received date descending, including reference number, proposal, status, decision, appeal details, key dates, constraints, and linked documents:

• plus.property.attributes.status.planning_applications

Windows description as recorded on the EPC certificate:

• property.attributes.status.windows_description

Walls description as recorded on the EPC certificate:

• property.attributes.status.walls_description

Roof description as recorded on the EPC certificate:

• property.attributes.status.roof_description

Floor description as recorded on the EPC certificate:

• property.attributes.status.floor_description

Property type as recorded on the EPC certificate:

• property.attributes.status.epc_property_type

Built form as recorded on the EPC certificate:

• property.attributes.status.epc_built_form

Floor height in metres as recorded on the EPC certificate, where available:

• property.attributes.status.floor_height_declared_only

Floor height in metres, taken from the EPC where available and otherwise estimated from the postcode/property-type median:

• property.attributes.status.floor_height_declared_and_predicted

Modelled floor height in metres from the postcode/property-type median; null where an EPC value exists:

• property.attributes.status.floor_height_predicted_only

Whether the property contains an airing cupboard:

• property.attributes.indoor.airing_cupboard

Overall property condition ('excellent', 'good', 'fair', 'poor', or 'unknown'):

• plus.property.attributes.indoor.condition

Overall interior finish quality ('low', 'medium', 'high', or 'unknown'):

• plus.property.attributes.indoor.finish_quality

Quality of kitchen finish ('low', 'medium', 'high', or 'unknown'):

• plus.property.attributes.indoor.kitchen_finish_quality

Whether the kitchen appears recently refitted:

• plus.property.attributes.indoor.kitchen_recently_refitted

Dominant kitchen countertop material ('laminate', 'solid_wood', 'granite', 'quartz', 'composite_stone', 'marble', 'tile', 'stainless_steel', 'concrete', 'other', or 'unknown'):

• plus.property.attributes.indoor.kitchen_countertop_material

Quality of bathroom finish ('low', 'medium', 'high', or 'unknown'):

• plus.property.attributes.indoor.bathroom_finish_quality

Whether the bathroom appears recently refitted:

• plus.property.attributes.indoor.bathroom_recently_refitted

Dominant flooring type ('carpet', 'hardwood', 'laminate', 'tile', 'stone', 'vinyl', 'mixed', or 'unknown'):

• plus.property.attributes.indoor.primary_floor_type

Primary window type ('standard', 'bay', 'sash', 'bay_and_sash', 'mixed', 'skylight', or 'unknown'):

• plus.property.attributes.indoor.window_type

Approximate radiator age ('modern', 'dated', 'vintage', 'mixed', or 'unknown'):

• plus.property.attributes.indoor.radiator_age

Evidence the loft has been converted to habitable space:

• plus.property.attributes.indoor.attic_or_loft_conversion

Whether skylights are visible:

• plus.property.attributes.indoor.skylights

Whether at least one balcony is present:

• plus.property.attributes.indoor.balcony

Whether a chimney is visible from the roofline:

• plus.property.attributes.indoor.chimney

Whether a dedicated home-office space is visible:

• plus.property.attributes.indoor.home_office

Whether the property is cottage-style (beams, wood burner, thatch, old construction):

• plus.property.attributes.indoor.cottage_style

Likelihood that the property has a header tank:

• premium.property.attributes.indoor.header_tank_probability

Predicted finish category of the property, such as basic, modern or luxury:

• premium.property.value.rebuild.predicted_rebuild_finish

Local National Grid x coordinate (British National Grid in Great Britain; Irish Grid in Northern Ireland). Legacy name: easting:

• property.attributes.status.x_local_grid

Local National Grid y coordinate (British National Grid in Great Britain; Irish Grid in Northern Ireland). Legacy name: northing:

• property.attributes.status.y_local_grid

Deprecated fields

Deprecated in favour of x_local_grid and y_local_grid:

• property.attributes.status.easting, property.attributes.status.northing

New billing system based on actual pound balance instead of credits, as well as support for pre-paid request packs for volume discounts. This introduces new headers:

chimnie-balance-used: Amount deducted from your balance for the request.

chimnie-balance-remaining: Balance remaining after the request.

chimnie-pack-used: Number of pack request units consumed by the request. 

chimnie-pack-kind: The kind (core / plus / premium / commercial) of the pack that satisfied the request. 

chimnie-pack-remaining: Number of requests remaining across all your active packs of that kind, after the request. 

Former credit-based headers will be kept for backwards compatibility for some time.

Full details on the current billing system are available in our documentation https://docs.chimnie.com/#billing-system

New fields

Estimated rebuild cost for different kind of finishes.

• premium.property.value.rebuild.basic_finish_rebuild_cost_estimate
• premium.property.value.rebuild.modern_finish_rebuild_cost_estimate
• premium.property.value.rebuild.luxury_finish_rebuild_cost_estimate

Breakdowns on material and labour cost for modern finish rebuilds.

• premium.property.value.rebuild.modern_finish_material_cost_estimate
• premium.property.value.rebuild.modern_finish_labour_cost_estimate

Please note that the premium.property.value.rebuild.estimated_rebuild_cost is now deprecated and these new fields should be used instead, although the former field will be kept indefinitely for backwards compatibility.

Commercial Property Data API released.

The force_residential field is now deprecated, please use the new commercial data endpoints to request data for commercial and dual use properties.

New fields

Images of the property from previous listings.

• property.attributes.images.listing_images

Floorplans of the property.

• property.attributes.images.floorplan_images

Clearer predicted fields

We've improved how we expose predicted values by splitting them into three distinct categories:

• [field]_declared_only: Values officially declared in public records.
• [field]_predicted_only: Values derived purely from our prediction models. Will be null when there is a declared value available.
• [field]_declared_and_predicted: Combined values from both predicted and declared.

While the legacy fields are now deprecated, they will remain available for backwards compatibility.

For example, the bedrooms count fields are now structured as:

• New field: bedrooms_declared_only - Legacy field: bedrooms

• New field: bedrooms_declared_and_predicted - Legacy field: bedrooms_predicted

• New field: bedrooms_predicted_only -  Legacy field: N/A