Get Properties
Retrieve properties by outward code or full postcode, with optional UDPRN filtering and pagination.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Request Body
Outward code (first part of postcode), e.g. 'SW1A'. Provide either this or postcode, not both.
Full UK postcode, e.g. 'SW1A 1AA'. Provide either this or first_postcode, not both.
Filter by UDPRN presence. 'y' = only addresses with UDPRN, 'n' = only addresses without UDPRN. Default null (no filter).
limitNumber of results per page. Default 100, max 100.
page0-based page index. Offset = page * limit. Default 0.
Responses
List of properties with address and valuation data
property_idInternal id allocated to a property.
fabric_availableWhether EPC fabric data is available (1 = yes, 0 = no).
Number of bedrooms.
Number of reception rooms.
Number of bathrooms.
Property type, e.g. 'flat', 'detached', 'terraced'.
Total floor area of the property.
Number of habitable rooms from EPC data.
Built form of the property, e.g. 'flat', 'detached'.
Property tenure type.
Predicted room count (modelled).
Predicted total floor area (modelled).
Automated valuation model selling estimate.
Internal place ID linked to the property postcode.
Unique Property Reference Number.
Unique Delivery Point Reference Number.
Outward code (first part of postcode).
Full UK postcode.
Town name.
Dependent locality.
Double dependent locality.
Street/road name.
Dependent thoroughfare.
Building number.
Building name.
Sub-building name (e.g. flat number).
Address classification code.
PO Box number.
Department name within an organisation.
Organisation name at the address.
Postcode type indicator (S = small, L = large).
Small user organisation indicator.
Representative Point Code.
Local custodian code for the address.
Primary addressable object name.
Secondary addressable object name.
Country where the property is located.
Get Property Detail
Retrieve detailed property information by property_id, uprn, or udprn.
query Parameters
property_iduprnudprnHeaders
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Responses
Detailed property data with address, valuation, EPC, and title info
Internal ID allocated to a property.
Number of bedrooms in property.
Number of reception rooms in property.
Number of bathrooms in property.
Type of property (e.g., Detached, Flat).
Internal size in sqm (aliased from total_floor_area).
Building construction type (semi, detached, terrace).
Freehold or Leasehold tenure.
1 = Building fabric features are modelled; 0 = From valid source.
1 = Size is modelled based on similar properties; 0 = Size is measured/accurate.
Estimated current valuation based on available comparables.
Unique Property Reference Number (OS).
Unique Delivery Point Reference Number (Royal Mail).
Postcode outcode (e.g., SW1A).
Full Postal Code of the address.
Post Town of the address.
Locality used when thoroughfares are not unique within a town.
Secondary locality used to further distinguish address locations.
Street or road name.
Secondary street name.
Number of the premise on the street.
Name of the residential or commercial premise.
Specific unit name/number (e.g., Flat 1).
Property classification code (e.g., RD02).
PO Box number if applicable.
Specific department within an organisation.
Name of the organisation at this address.
L = Commercial, S = Residential.
Y = Commercial premises, N/Null = Not commercial.
Two-character code used to identify a unique delivery point.
Royal Mail Address status code.
Local authority identifier code.
Primary Addressable Object Name (Property Number).
Secondary Addressable Object Name (Building Number).
WGS84 Latitude coordinate of the property location.
WGS84 Longitude coordinate of the property location.
1 = EPC/Fabric data is available; 0 = Not available.
Standardized age band of the property (e.g., 1900-1929).
Current EPC Energy Efficiency Rating (A-G).
Full single-line formatted address string including postcode.
Country of address location (England, Wales, etc.).
Total land area of the plot measured in Square Feet.
Measures the density of properties in the surrounding area.
Human-readable description of the class code (e.g., Semi-Detached).
1 = Property is residential; 0 = Non-residential.
Indicates if the property is a known House in Multiple Occupation.
Predicted likelihood that the property is an HMO.
Remaining or original term length of a short lease.
The date on which the current short lease is set to expire.
Council Tax band (A-I).
Comma-separated list of HMLR Title Numbers linked to this UPRN.
Get EPC Fabric
Retrieve EPC fabric data (energy performance, building characteristics, costs) by property_id or postcode.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Request Body
Property unique identifier. Provide either this or postcode, not both.
UK postcode, e.g. 'SW1A 1AA'. Provide either this or property_id, not both.
Responses
EPC fabric data for a property
Primary unique identifier for the EPC record.
Internal property code key; also known as property_id.
First line of address (combination of Soan + Poan + Throughfair).
Second line of address (e.g., village name).
Town.
The UK postcode associated with the property address.
Reference number of the building for mail.
Current EPC rating (A-G).
Potential EPC rating after recommended improvements.
Current Energy Efficiency numerical value.
Potential Energy Efficiency numerical value.
The date the EPC inspection took place.
Name of the local authority.
Constituency catchment area.
County where the address is located.
Date the EPC was registered/lodged.
Reason for EPC (e.g., Rental, New Build, Property Sale).
Current Environmental Impact Rating (CO2 emissions in tonnes/year).
Potential Environmental Impact Rating after improvements.
Current estimated annual energy consumption (kWh/m2).
Potential estimated annual energy consumption (kWh/m2).
CO2 emissions per year in tonnes/year.
CO2 emissions per m2 floor area per year in kg/m2.
Estimated potential total annual CO2 emissions (Tonnes/Year).
Current estimated annual energy costs for lighting (GBP).
Potential estimated annual energy costs for lighting (GBP).
Current estimated annual energy costs for heating (GBP).
Potential annual energy costs for heating (GBP).
Current estimated annual energy costs for hot water (GBP).
Potential estimated annual energy costs for hot water (GBP).
Total useful floor area (m2) measured internally.
Type of electricity tariff (e.g., single or dual).
Indicates if mains gas is available (Yes/No).
Floor level relative to lowest level (0 for ground floor).
Whether the flat is on the top storey (Yes/No).
The total number of storeys in the apartment block.
Type of main heating controls present.
Estimated percentage range of total glazed area that is multi-glazed.
Type of glazing (single, double, or triple).
Ranged estimate of total glazed area of the habitable area.
Raw count of extensions to the property.
Count of habitable rooms (excludes kitchens/bathrooms).
Count of rooms with active heating.
Percentage of fixed lights that are low-energy.
The number of active open fireplaces in the property.
Overall description of the hot water system.
Energy efficiency rating for hot water (1 to 5 stars).
Environmental efficiency rating for hot water (1 to 5 stars).
Overall description of the floor construction.
Energy efficiency rating for floors (1 to 5 stars).
Environmental efficiency rating for floors (1 to 5 stars).
Overall description of windows/glazing features.
Energy efficiency rating for windows (1 to 5 stars).
Environmental efficiency rating for windows (1 to 5 stars).
Description of wall construction (e.g., cavity, solid).
Energy efficiency rating for walls (1 to 5 stars).
Environmental efficiency rating for walls (1 to 5 stars).
Method used for secondary heating, if any.
Energy efficiency rating for secondary heating.
Environmental efficiency rating for secondary heating.
Description of roof and insulation status.
Energy efficiency rating for the roof.
Environmental efficiency rating for the roof.
Description of the primary source of heating.
Energy efficiency rating for main heating.
Environmental efficiency rating for main heating.
Description of main heating controls.
Energy efficiency rating for main heating controls.
Environmental efficiency rating for main heating controls.
Description of fixed lighting outlets.
Energy efficiency rating for lighting.
Environmental efficiency rating for lighting.
Primary fuel type for central heating (e.g., Gas).
Number of wind turbines present at the property.
Presence and type of heat loss corridor (flats only).
Length of sheltered wall in unheated corridor (m).
Average height of the storey in metres.
Size of photovoltaic installation (kW).
Indicates if hot water is solar powered.
Type of mechanical ventilation used in the property.
Concatenated address (Address 1 + 2 + 3).
Descriptive name of the local authority.
Descriptive name of the parliamentary constituency.
Estimated age of the property (Standardized).
Property extension count; returns 'Unknown' if null.
Standardized classification of the roof structure.
Presence and type of conservatory; returns 'Unknown' if null.
Get EPC Fabric By Property ID
Retrieve EPC fabric data (energy performance, building characteristics, costs) by property_id.
query Parameters
property_idHeaders
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Responses
EPC fabric data for a property
Primary unique identifier for the EPC record.
Internal property code key; also known as property_id.
First line of address (combination of Soan + Poan + Throughfair).
Second line of address (e.g., village name).
Town.
The UK postcode associated with the property address.
Reference number of the building for mail.
Current EPC rating (A-G).
Potential EPC rating after recommended improvements.
Current Energy Efficiency numerical value.
Potential Energy Efficiency numerical value.
The date the EPC inspection took place.
Name of the local authority.
Constituency catchment area.
County where the address is located.
Date the EPC was registered/lodged.
Reason for EPC (e.g., Rental, New Build, Property Sale).
Current Environmental Impact Rating (CO2 emissions in tonnes/year).
Potential Environmental Impact Rating after improvements.
Current estimated annual energy consumption (kWh/m2).
Potential estimated annual energy consumption (kWh/m2).
CO2 emissions per year in tonnes/year.
CO2 emissions per m2 floor area per year in kg/m2.
Estimated potential total annual CO2 emissions (Tonnes/Year).
Current estimated annual energy costs for lighting (GBP).
Potential estimated annual energy costs for lighting (GBP).
Current estimated annual energy costs for heating (GBP).
Potential annual energy costs for heating (GBP).
Current estimated annual energy costs for hot water (GBP).
Potential estimated annual energy costs for hot water (GBP).
Total useful floor area (m2) measured internally.
Type of electricity tariff (e.g., single or dual).
Indicates if mains gas is available (Yes/No).
Floor level relative to lowest level (0 for ground floor).
Whether the flat is on the top storey (Yes/No).
The total number of storeys in the apartment block.
Type of main heating controls present.
Estimated percentage range of total glazed area that is multi-glazed.
Type of glazing (single, double, or triple).
Ranged estimate of total glazed area of the habitable area.
Raw count of extensions to the property.
Count of habitable rooms (excludes kitchens/bathrooms).
Count of rooms with active heating.
Percentage of fixed lights that are low-energy.
The number of active open fireplaces in the property.
Overall description of the hot water system.
Energy efficiency rating for hot water (1 to 5 stars).
Environmental efficiency rating for hot water (1 to 5 stars).
Overall description of the floor construction.
Energy efficiency rating for floors (1 to 5 stars).
Environmental efficiency rating for floors (1 to 5 stars).
Overall description of windows/glazing features.
Energy efficiency rating for windows (1 to 5 stars).
Environmental efficiency rating for windows (1 to 5 stars).
Description of wall construction (e.g., cavity, solid).
Energy efficiency rating for walls (1 to 5 stars).
Environmental efficiency rating for walls (1 to 5 stars).
Method used for secondary heating, if any.
Energy efficiency rating for secondary heating.
Environmental efficiency rating for secondary heating.
Description of roof and insulation status.
Energy efficiency rating for the roof.
Environmental efficiency rating for the roof.
Description of the primary source of heating.
Energy efficiency rating for main heating.
Environmental efficiency rating for main heating.
Description of main heating controls.
Energy efficiency rating for main heating controls.
Environmental efficiency rating for main heating controls.
Description of fixed lighting outlets.
Energy efficiency rating for lighting.
Environmental efficiency rating for lighting.
Primary fuel type for central heating (e.g., Gas).
Number of wind turbines present at the property.
Presence and type of heat loss corridor (flats only).
Length of sheltered wall in unheated corridor (m).
Average height of the storey in metres.
Size of photovoltaic installation (kW).
Indicates if hot water is solar powered.
Type of mechanical ventilation used in the property.
Concatenated address (Address 1 + 2 + 3).
Descriptive name of the local authority.
Descriptive name of the parliamentary constituency.
Estimated age of the property (Standardized).
Property extension count; returns 'Unknown' if null.
Standardized classification of the roof structure.
Presence and type of conservatory; returns 'Unknown' if null.
Get EPC Fabric By Postcode
Retrieve EPC fabric data (energy performance, building characteristics, costs) by postcode.
query Parameters
postcode^(?i)([A-Z]{1,2}\d[A… · requiredHeaders
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Responses
EPC fabric data for a postcode
Primary unique identifier for the EPC record.
Internal property code key; also known as property_id.
First line of address (combination of Soan + Poan + Throughfair).
Second line of address (e.g., village name).
Town.
The UK postcode associated with the property address.
Reference number of the building for mail.
Current EPC rating (A-G).
Potential EPC rating after recommended improvements.
Current Energy Efficiency numerical value.
Potential Energy Efficiency numerical value.
The date the EPC inspection took place.
Name of the local authority.
Constituency catchment area.
County where the address is located.
Date the EPC was registered/lodged.
Reason for EPC (e.g., Rental, New Build, Property Sale).
Current Environmental Impact Rating (CO2 emissions in tonnes/year).
Potential Environmental Impact Rating after improvements.
Current estimated annual energy consumption (kWh/m2).
Potential estimated annual energy consumption (kWh/m2).
CO2 emissions per year in tonnes/year.
CO2 emissions per m2 floor area per year in kg/m2.
Estimated potential total annual CO2 emissions (Tonnes/Year).
Current estimated annual energy costs for lighting (GBP).
Potential estimated annual energy costs for lighting (GBP).
Current estimated annual energy costs for heating (GBP).
Potential annual energy costs for heating (GBP).
Current estimated annual energy costs for hot water (GBP).
Potential estimated annual energy costs for hot water (GBP).
Total useful floor area (m2) measured internally.
Type of electricity tariff (e.g., single or dual).
Indicates if mains gas is available (Yes/No).
Floor level relative to lowest level (0 for ground floor).
Whether the flat is on the top storey (Yes/No).
The total number of storeys in the apartment block.
Type of main heating controls present.
Estimated percentage range of total glazed area that is multi-glazed.
Type of glazing (single, double, or triple).
Ranged estimate of total glazed area of the habitable area.
Raw count of extensions to the property.
Count of habitable rooms (excludes kitchens/bathrooms).
Count of rooms with active heating.
Percentage of fixed lights that are low-energy.
The number of active open fireplaces in the property.
Overall description of the hot water system.
Energy efficiency rating for hot water (1 to 5 stars).
Environmental efficiency rating for hot water (1 to 5 stars).
Overall description of the floor construction.
Energy efficiency rating for floors (1 to 5 stars).
Environmental efficiency rating for floors (1 to 5 stars).
Overall description of windows/glazing features.
Energy efficiency rating for windows (1 to 5 stars).
Environmental efficiency rating for windows (1 to 5 stars).
Description of wall construction (e.g., cavity, solid).
Energy efficiency rating for walls (1 to 5 stars).
Environmental efficiency rating for walls (1 to 5 stars).
Method used for secondary heating, if any.
Energy efficiency rating for secondary heating.
Environmental efficiency rating for secondary heating.
Description of roof and insulation status.
Energy efficiency rating for the roof.
Environmental efficiency rating for the roof.
Description of the primary source of heating.
Energy efficiency rating for main heating.
Environmental efficiency rating for main heating.
Description of main heating controls.
Energy efficiency rating for main heating controls.
Environmental efficiency rating for main heating controls.
Description of fixed lighting outlets.
Energy efficiency rating for lighting.
Environmental efficiency rating for lighting.
Primary fuel type for central heating (e.g., Gas).
Number of wind turbines present at the property.
Presence and type of heat loss corridor (flats only).
Length of sheltered wall in unheated corridor (m).
Average height of the storey in metres.
Size of photovoltaic installation (kW).
Indicates if hot water is solar powered.
Type of mechanical ventilation used in the property.
Concatenated address (Address 1 + 2 + 3).
Descriptive name of the local authority.
Descriptive name of the parliamentary constituency.
Estimated age of the property (Standardized).
Property extension count; returns 'Unknown' if null.
Standardized classification of the roof structure.
Presence and type of conservatory; returns 'Unknown' if null.