PropertyData API - Complete Documentation

Input a full UK address and receive up to the 10 most closely matching UPRNs and the following information (where available):

• uprn - Unique Property Reference Number
• address - UPRN address
• UPRN latitude and longitude
• classificationCode - A code that describes the classification of the UPRN property type
• classificationCodeDesc - Description of the above classification code

Input

Tips to improve your search results:

• Ensure a full valid UK postcode is included in the address, with the correct spacing.
• Results can be greatly improved by including commas to separate your search terms e.g. 'Ordnance Survey, 4, Adanac Drive, Nursling, SO16 0AS'
• Make sure the address elements in your search are in the correct order.
• Make sure you provide enough information when searching for an address. Remember that postcodes can cover up to 99 properties, therefore including a street name and building name/number will narrow down the search results.
• Don't over complicate your search with unnecessary elements e.g. 'Room 301, Level 3, Organisation Name, Building Name, Street, Postcode'.

Example

https://api.propertydata.co.uk/address-match-uprn?key={API_KEY}&address=Ordnance Survey, 4, Adanac Drive, Nursling, SO16 0AS

For one of the following:

• A UK postcode (full, district or sector)
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK
• A town or city in the UK

This endpoint returns analytics on estate agent market share in the area.

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Input

Example

https://api.propertydata.co.uk/agents?key={API_KEY}&postcode=W14

Analyse buildings on a given land title number. Land title numbers can be found using the /freeholds API endpoint if required.

Input

Example

https://api.propertydata.co.uk/analyse-buildings?key={API_KEY}&title=ON60618

For one of the following:

• A full UK postcode
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK
• A town or city in the UK

This endpoint returns whether the provided location is within an Area of Outstanding National Beauty (AONB) and if applicable the AONB name.

If a town name is the supplied input, this endpoint will return a positive match for an AONB if the center point of the town is within the AONB.

Input

Example

https://api.propertydata.co.uk/aonb?key={API_KEY}&postcode=OX7+3EX

For one of the following:

• A full UK postcode
• A town or city in the UK

This endpoint returns the type of area.

If a town name is supplied, this endpoint will return the most common area type based on the postcodes within the town.

Possible values for the 'area_type' field are: Accessible rural areaRemote rural areaRemote small townRural hamlet and isolated dwellingsRural hamlet and isolated dwellings in a sparse settingRural town and fringeRural town and fringe in a sparse settingRural villageRural village in a sparse settingVery remote rural areaVery remote small townAccessible small townLarge urban areaOther urban areaUrban city and townUrban city and town in a sparse settingUrban major conurbationUrban minor conurbation

Input

Example

https://api.propertydata.co.uk/area-type?key={API_KEY}&postcode=OX44+9LW

For one of the following:

• A full UK postcode
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK
• A town or city in the UK

Along with an internal area (in square feet) and required finish quality, this endpoint returns the estimated building cost as both total build cost and cost per square foot.

If a town name is the supplied input, this endpoint will will calculate build cost for a location in the center of the town.

Input

Example

https://api.propertydata.co.uk/build-cost?key={API_KEY}&postcode=CF158RU&internal_area=2500&finish_quality=medium&project_type=refurb_heavy

For one of the following:

• A full postcode in England
• The latitude & longitude co-ordinates of a location in England
• A what3words address in England
• A town or city in the UK

This endpoint returns whether the location is within a conservation area and if applicable the conservation area name.

If a town name is the supplied input, this endpoint will return a positive match for a conservation area if the center point of the town is within the conservation area.

Note: the coverage for this data is partial across England as not all Local Authorities have supplied this data.

Input

Example

https://api.propertydata.co.uk/conservation-area?key={API_KEY}&postcode=EX35+6EQ

For a full UK postcode, returns analytics on average council tax by property band in the council area, plus a rating on how well this council is performing on keeping tax low. Additionally returns known individual property council tax bands for the area.

Coverage note: in Scotland, only council tax band averages are available, not individual property band data.

Input

Example

https://api.propertydata.co.uk/council-tax?key={API_KEY}&postcode=W14+9JH

Number of properties returned limited in example response for brevity

For one of the following:

• A postcode (full, district or sector) in England or Wales
• The latitude & longitude co-ordinates of a location in England or Wales
• A what3words address in England or Wales
• A town or city in England or Wales

This endpoint returns analytics on local crime for the specified input.

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Possible values for the 'crime_rating' field are: Very high crimeHigh crimeAverage crimeLow crimeVery low crime

Possible labels within 'types' are: Anti-social behaviourViolence and sexual offencesCriminal damage and arsonOther theftVehicle crimeBurglaryPublic orderShopliftingDrugsTheft from the personBicycle theftOther crimeRobberyPossession of weapons

Input

Example

https://api.propertydata.co.uk/crime?key={API_KEY}&postcode=W14+9JH

For one of the following:

• A postcode (full, district or sector) in England or Wales
• The latitude & longitude co-ordinates of a location in England or Wales
• A what3words address in England or Wales
• A town or city in England or Wales

This endpoint returns local property demand analytics.

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Possible values for the 'demand_rating' field are: Seller's marketBalanced marketBuyer's market

Input

Example

https://api.propertydata.co.uk/demand?key={API_KEY}&postcode=W14

For one of the following:

• A UK postcode (full, district or sector)
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK
• A town or city in the UK

This endpoint returns local property rental demand analytics.

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Possible values for the 'rental_demand_rating' field are: Landlord's marketBalanced marketTenant's market

Input

Example

https://api.propertydata.co.uk/demand-rent?key={API_KEY}&postcode=W14

For one of the following:

• A UK postcode (full, district or sector)
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK
• A town or city in the UK

This endpoint returns population demographic data from the smallest radius at which there is reasonable data.

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Input

Example

https://api.propertydata.co.uk/demographics?key={API_KEY}&postcode=W149JH

How much profit will a development make?

For one of the following:

• A full UK postcode
• A town or city in the UK

Our development calculator combines construction cost data with real-time market data on values per square foot to help you estimate how much profit a development will make.

Results will be returned as formatted strings for presentation unless the 'return_formatted_strings' parameter is set to false in which case numeric types will be returned.

If a town name is the supplied, a postcode in the center of the town will be used in the calculations.

Input

Example

https://api.propertydata.co.uk/development-calculator?key={API_KEY}&postcode=W149JH&purchase_price=1000000&sqft_pre_development=2000&sqft_post_development=3000&project_type=refurbish&finish_quality=medium&return_formatted_strings=true

For one of the following:

• A full UK postcode
• A town or city in the UK

This endpoint takes a range of required parameters relating to a particular UK multi-unit development and returns an estimated gross development value (with +/- margin of error) for that property, as well as a total rental value. The only available AVM in the UK that uses market £/sqft data as part of the valuation.

If a town name is the supplied, a postcode in the center of the town will be used in the calculations.

Input

Example

https://api.propertydata.co.uk/development-gdv?key={API_KEY}&postcode=NW6+7YD&flat_2=4&flat_1=1&finish_quality=medium&internal_area=2000

For a full UK postcode, returns energy efficiency scores and ratings of properties in that postcode.

Input

Example

https://api.propertydata.co.uk/energy-efficiency?key={API_KEY}&postcode=W14+9JH

Amount of energy efficiency data returned limited in example response for brevity

For one of the following:

• A full postcode in England
• The latitude & longitude co-ordinates of a location in England
• A what3words address in England

This endpoint returns the risk of flooding from rivers and sea.

If a postcode is supplied the flood risk rating returned will be that of the center point of the postcode. Co-ordinate locations and What3Word addresses will return the flood risk at the specified point.

Possible flood risk values are:

Input

Example

https://api.propertydata.co.uk/flood-risk?key={API_KEY}&w3w=pretty.needed.chill

For a full UK postcode, returns known floor areas of properties in that postcode.

Input

Example

https://api.propertydata.co.uk/floor-areas?key={API_KEY}&postcode=W14+9JH

Number of floor areas returned limited in example response for brevity

For one of the following:

• A full UK postcode
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK

This endpoint returns freehold land title numbers, along with the title class and headline information about the associated polygons including approx centres and number of leaseholds. You can then use the /title or /analyse-buildings endpoint to look up further information (e.g. full boundaries) for titles of interest, if desired.

Input

Example

https://api.propertydata.co.uk/freeholds?key={API_KEY}&postcode=NW6+7YD&results=53

Number of freehold titles returned limited in example response for brevity

For one of the following:

• A full UK postcode
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK
• A town or city in the UK

This endpoint returns whether the location is within the green belt and if applicable the green belt name.

If a town name is the supplied input, this endpoint will return a positive match if the center point of the town is within a green belt.

Input

Example

https://api.propertydata.co.uk/green-belt?key={API_KEY}&postcode=OX44+9LW

For one of the following:

• A UK postcode (full, district or sector)
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK
• A town or city in the UK

This endpoint returns five-year capital growth figures.

The percentage growth figures returned by the API indicate year-on-year capital growth and not accumulative growth over the five-year period.

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Input

Example

https://api.propertydata.co.uk/growth?key={API_KEY}&postcode=W14

For one of the following:

• A UK postcode (full, district or sector)
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK
• A town or city in the UK

This endpoint returns five-year growth per property square foot figures. The values returned indicate the average price per square foot for properties sold in the targeted area in the previous 12 months.

The percentage growth figures returned by the API indicate year-on-year growth per square foot and not accumulative growth over the five-year period.

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Input

Example

https://api.propertydata.co.uk/growth-psf?key={API_KEY}&postcode=W14

For one of the following:

• A postcode district (eg: OX7)
• A postcode sector (eg: OX7 3)
• A full UK postcode and a radius in miles
• A lat/lng location within the UK and a radius in miles
• A what3words address in the UK and a radius in miles
• A town or city in the UK

This endpoint returns the average household income (GBP) for an area of interest.

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Input

Example

https://api.propertydata.co.uk/household-income?key={API_KEY}&postcode=OX7+3EX

For a full postcode UK postcode, returns analytics on the internet speeds available.

Input

Example

https://api.propertydata.co.uk/internet-speed?key={API_KEY}&postcode=DY3+2QG

Purchase a Title Register and/or Title Plan for a given Title Number from the Land Registry.

A successful request to this endpoint will return a 'document_url' which can be used to download the selected documents for the next 6 months.

Land Registry business hours operate between 06:30 - 23:00 daily. If a document is requested outside of these business hours, the request will be queued and dealt with by the Land Registry during their business hours. Further details and an example of this sort of response can be found in the 'Example' section below.

Pricing:

Each document you purchase costs £7.50 + VAT

Your stored payment card will be billed once your pending payment balance exceeds your pending payment limit, or with your next monthly subscription payment.

The default limit is £10.00 + VAT for users with an active subscription, or £7.50 + VAT for users in the free trial period.

We may increase your balance at our discretion based on your purchase volumes. You can check your pending payment balance (once created) at anytime from the Subscription page on your account.

Proprietorship data:

For an additional £1.00 + VAT per document PropertyData can attempt to read the proprietor name and property address from the Land Registry register of title, along with any mortgage charges on the property.

To do this pass the extract_proprietor_data parameter with a value of true.

This feature works with the register or both documents types, you will only be billed if the data is successfully extracted.

Input

Example

https://api.propertydata.co.uk/land-registry-documents?key={API_KEY}&title=ND66318&documents=both&extract_proprietor_data=true

If the Land Registry is unable to process your request the following will be returned from the PropertyData API. You will not be billed for the request or document(s)

Land Registry business hours operate between 06:30 - 23:00 daily. If a document is requested outside of these business hours, the request will be queued and dealt with by the Land Registry during their business hours. The PropertyData API will return a value of 'pending' for the 'document_status' field and a timestamp for when we estimate the document will be available to download.

The document_url will return a 400 error until the document is available to download. Once available the document will be returned with a 200 status. If, once the request is processed by the land registry, the document is not available the document_url endpoint will return a 400 status with the following error

The proprietor_data_url will return a 400 error until the data is available. Once available the data will be returned in JSON format with a 200 status as below

If, once the request is processed by the land registry, the proprietor data is not available the proprietor_data_url endpoint will return a 400 status with the following error message

For a full UK postcode and property size (1-4 bedrooms), returns information on the Local Housing Allowance rate for the number of bedrooms requested.

Also returns the LHA rate for shared accommodation in the supplied postcode.

Input

Example

https://api.propertydata.co.uk/lha-rate?key={API_KEY}&postcode=W14+9JH&bedrooms=2

For one of the following:

• A full postcode in England
• The latitude & longitude co-ordinates of a location in England
• A what3words address in England

This endpoint returns up to 10 of the closest listed buildings which match the supplied filters.

Input

I, II* or II

Example

https://api.propertydata.co.uk/listed-buildings?key={API_KEY}&postcode=NW6+7YD&grade=II*&listed_after=1975

Number of planning data points returned limited in example response for brevity

Calculate monthly repayments, total mortgage cost and total interest payable on a fixed term repayment mortage.

This calculator is a ready reckoner that has been designed to give a general indication of costs. The results are rounded.

Input

Example

https://api.propertydata.co.uk/mortgage-calculator?key={API_KEY}&principal=350000&rate=4.5&years=25

Get average mortage interest rates for a 2 or 3 year fixed rate deal (75% LTV) or the average standard variable rate.

Input

Example

https://api.propertydata.co.uk/mortgage-rates?key={API_KEY}

The National HMO Register is a database that combines HMO registers from councils all over England & Wales to try to create a national picture of registered HMOs.

For one of the following:

• A full postcode in England or Wales
• The latitude & longitude co-ordinates of a location in England or Wales
• A what3words address in England or Wales

This endpoint return the closest HMOs from the National HMO Register.

Input

Example

https://api.propertydata.co.uk/national-hmo-register?key={API_KEY}&postcode=NW6+7YD&results=20

Number of HMOs returned limited in example response for brevity

For one of the following:

• A full UK postcode
• A town or city in the UK

This endpoint returns whether the property is within a national park (and if applicable the national park name).

If a town name is the supplied input, this endpoint will return a positive match if the center point of the town is within the national park.

Input

Example

https://api.propertydata.co.uk/national-park?key={API_KEY}&postcode=EX35+6EQ

For one of the following:

• A full UK postcode
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK

This endpoint returns the closest planning applications that match the optional filters.

Input

Example

https://api.propertydata.co.uk/planning-applications?key={API_KEY}&postcode=NW6+7YD&decision_rating=positive&category=tree,small%20residential&max_age=120&results=20

Number of planning data points returned limited in example response for brevity

For one of the following:

• A full UK postcode
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK

This endpoint returns the general election constituency within which the location sits, and recent election results.

Input

Example

https://api.propertydata.co.uk/politics?key={API_KEY}&postcode=W14+9JH

Get total population, number of households and population density information for an area of interest.

To specify the area to generate data for, this endpoint will accept any of the following:

• A postcode district (eg: OX7)
• A postcode sector (eg: OX7 3)
• A full UK postcode and a radius in miles
• A lat/lng location within the UK and a radius in miles
• A what3words address in the UK and a radius in miles
• A town or city in the UK

This endpoint returns the following data:

• population - total population for the input area
• households - total number of households in the input area
• density - population density (people per square mile) for the input area

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Input

Example

https://api.propertydata.co.uk/population?key={API_KEY}&postcode=OX7+3EX

Returns key stats on postcode districts in a UK region.

Input

Example

https://api.propertydata.co.uk/postcode-key-stats?key={API_KEY}&region=south_east

Number of postcode districts returned limited in example response for brevity

For one of the following:

• A UK postcode (full, district or sector)
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK
• A town or city in the UK

This endpoint returns statistical average and confidence intervals of live property asking prices, from the smallest radius at which there is reasonable data.

Results can optionally be filtered by bedroom and property type

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Input

Example

https://api.propertydata.co.uk/prices?key={API_KEY}&postcode=W149JH&bedrooms=2

Raw data omitted from example response for brevity

For one of the following:

• A UK postcode (full, district or sector)
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK
• A town or city in the UK

This endpoint returns statistical average and confidence intervals of live property asking prices per square foot, from the smallest radius at which there is reasonable data.

Read more about our price per square foot data here.

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Input

Example

https://api.propertydata.co.uk/prices-per-sqf?key={API_KEY}&postcode=W149JH

Raw data omitted from example response for brevity

For one of the following:

• A full UK postcode within Greater London
• The latitude & longitude co-ordinates of a location within Greater London
• A what3words address within Greater London

This endpoint returns the PTAL score.

Possible values for the 'ptal' field from worst to best are: 01a1b23456a6b

Input

Example

https://api.propertydata.co.uk/ptal?key={API_KEY}&postcode=W14+9JH

This calculator uses our construction cost data to estimate the approximate rebuild cost of a house anywhere in the UK. This may be useful for insurance purposes (although see our disclaimer). We don't currently provide a rebuild cost for flats.

Input

Example

https://api.propertydata.co.uk/rebuild-cost?key={API_KEY}&postcode=OX41YB&internal_area=900&site_quality=restricted

This estimate is strictly for guidance only and we are not liable for any loss or damage following use or reliance on the estimation provided. The rebuild cost calculation of any property remains the responsibility of the owner of the property. Providing an accurate rebuild cost for insurance or any other purpose remains your responsibility. If you are in any doubt about the accuracy of the rebuild cost of your property you should hire a chartered surveyor to provide a professional opinion.

For one of the following:

• A UK postcode (full, district or sector)
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK
• A town or city in the UK

This endpoint returns statistical average and confidence intervals of live property asking rents (long-let), from the smallest radius at which there is reasonable data. All rents are expressed as per week (for monthly values, multiply by 4.333)

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Input

Example

https://api.propertydata.co.uk/rents?key={API_KEY}&postcode=W149JH&bedrooms=2

Raw data omitted from example response for brevity

For one of the following:

• A UK postcode (full, district or sector)
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK
• A town or city in the UK

This endpoint returns statistical average and confidence intervals of the room rental market, segmented by double / single rooms and ensuite / shared bathroom.

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Input

Example

https://api.propertydata.co.uk/rents-hmo?key={API_KEY}&postcode=W149JH

For one of the following:

• A full UK postcode (excl Scotland)
• The latitude & longitude co-ordinates of a location in the UK (excl Scotland)
• A what3words address in the UK (excl Scotland)

This endpoint returns data about nearby restaurants.

Input

Example

https://api.propertydata.co.uk/restaurants?key={API_KEY}&postcode=OX73EX

For one of the following:

• A postcode (full, district or sector) in England
• The latitude & longitude co-ordinates of a location in England
• A what3words address in England
• A town or city in the UK

This endpoint returns data about nearby state and independent schools.

Possible values for the 'rating' field for state schools are:OutstandingGoodRequires improvementInadequateUnknown

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Input

Example

https://api.propertydata.co.uk/schools?key={API_KEY}&postcode=W21TR

Number of nearest schools returned limited in example response for brevity

Purchase an A4, A3 or A2 scale site plan for a given Land Registry Title Number, suitable for use with planning applications.

A range of scales between 1:100 and 1:2500 area available, depending on the paper size selected. See pricing tables below for options

A successful request to this endpoint will return a document_url which can be used to download the Site Plan PDF document for the next 6 months.

The site plan will be centered on the largest plot associated with the provided title.

For some Titles which cover a lot of land, the larger map scales will not be available. If this is the case you will receive a 400 error on the API with error code 3701. Try the call again using a smaller scale such that the map covers a larger area, for example 1:500 instead of 1:200.

Download sample Site Plan: A4 A3 A2

Pricing

Your stored payment card will be billed once your pending payment balance exceeds your pending payment limit, or with your next monthly subscription payment.

The default limit is £10.00 + VAT for users with an active subscription, or £7.50 + VAT for users in the free trial period.

We may increase your balance at our discretion based on your purchase volumes. You can check your pending payment balance (once created) at anytime from the Subscription page on your account.

Input

Example

https://api.propertydata.co.uk/site-plan-documents?key={API_KEY}&title=ON176985&scale=500&paper_format=A4

For one of the following:

• A UK postcode (full, district or sector)
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK
• A town or city in the UK

This endpoint returns statistical average and confidence intervals of property sold prices.

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Input

Example

https://api.propertydata.co.uk/sold-prices?key={API_KEY}&postcode=W149JH&type=flat&max_age=12

Raw data omitted from example response for brevity

For one of the following:

• A UK postcode (full, district or sector)
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK
• A town or city in the UK

This endpoint returns statistical average and confidence intervals of property sold prices per square foot.

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Input

Example

https://api.propertydata.co.uk/sold-prices-per-sqf?key={API_KEY}&postcode=W149JH

Raw data omitted from example response for brevity

For one of the following:

• A UK postcode (full, district or sector)
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK

This endpoint returns properties currently on any one of our specialist situation property sourcing lists, within a given radius of a supplied location. Properties are sorted by distance to the input location, where the closest properties are returned first.

Input

Example

https://api.propertydata.co.uk/sourced-properties?key={API_KEY}&list=repossessed-properties&postcode=NW6+7YD&radius=20&max_age=7&results=60

Number of properties returned limited in example response for brevity

Returns up to date information relating to a specific property as found on one of the sourcing lists.

The required property_id parameter is returned by the /sourced-properties API endpoint as id in the list of properties.

Input

Example

https://api.propertydata.co.uk/sourced-property?key={API_KEY}&property_id=Z70132997

If the property has been removed from the market, the below will be returned

For a given transaction value, calculates the transaction tax payable. Value returned depends on UK country and property type used, as defined by the mode selected. Supported modes include:

• Investment property (investment)
• Primary residence (primary)
• First-time buyer (first_time)
• Non-residential (non_resi)

Input

Example

https://api.propertydata.co.uk/stamp-duty-calculator?key={API_KEY}&value=250000&country=scotland&mode=investment&transaction_date=2025-02-12

For a given land title number (freehold or leasehold) returns the following information:

• Title class / estate interest
• Ownership type^[1]
• Total plot size^[2]
• Number of polygons of land in title
• List of polygons including polygon size ^[2], approximate polygon centre ^[3] and polygon co-ordinates ^[4]
• Attached leaseholds
• Attached UPRNs

^[1] plus owner details if corporate

^[2] measured in acres

^[3] latitude & longitude

^[4] list of latitudes & longitudes

Input

Example

https://api.propertydata.co.uk/title?key={API_KEY}&title=ON176985

Polygon co-ordinates returned limited in example response for brevity

For a given land title number (freehold or leasehold) predict planning use class:

Input

Example

https://api.propertydata.co.uk/title-use-class?key={API_KEY}&title=ON72197

For a given Unique Property Reference Number return the following data. UPRNs can be found from a title using the /title API endpoint.

• Property address, latitude / longitude and description
• Planning Use Class
• Last sold date and amount^[1]
• Current sale estimate^[1]
• Internal area^[1]
• Energy performance score (band rating and numeric score)^[1]
• Council tax band and rate^[1]
• Previous transactions^[1]

^[1] where available

Input

Example

https://api.propertydata.co.uk/uprn?key={API_KEY}&uprn=4510093370

Lookup the corresponding title number(s) for a given Unique Property Reference Number (UPRN):

Input

Example

https://api.propertydata.co.uk/uprn-title?key={API_KEY}&uprn=4510093370

For one of the following:

• A UK postcode
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK

This endpoint returns the following data (where available) about UPRNs in the area.

• uprn - Unique Property Reference Number
• address - UPRN address
• UPRN latitude and longitude
• classificationCode - A code that describes the classification of the UPRN property type
• classificationCodeDesc - Description of the above classification code

If 'strict' mode is set and a postcode is provided, this endpoint will only return UPRNs which are within the provided postcode.

Input

Example

https://api.propertydata.co.uk/uprns?key={API_KEY}&postcode=W149JH&strict=true

Number of properties returned limited in example response for brevity

Use regional long-term house price inflation data to estimate the value of this property on a previous date as far back as to 1973, assuming the property hasn't been extended or modified.

Input

Example

https://api.propertydata.co.uk/valuation-historical?key={API_KEY}&postcode=OX7+3EX&current_price=350000&historic_value_year=2000&historic_value_month=January

For a full UK postcode and a range of required parameters relating to a particular HMO in the UK, returns estimated sale and gross rental valuations for the HMO

Input

^[1] each individual room type is optional but a total of at least two rooms must be provided to value an HMO

Example

https://api.propertydata.co.uk/valuation-hmo?key={API_KEY}&postcode=OX41YB&finish_quality=very_high&living_room=true&parking=true&outside_space=true&room_double_en_suite=1&room_double=3

For a full UK postcode and a range of required parameters relating to a particular UK property, returns an estimated rental valuation for that property. The only available AVM in the UK that uses market £/sqft data as part of the valuation.

Input

Example

https://api.propertydata.co.uk/valuation-rent?key={API_KEY}&postcode=OX41YB&internal_area=828&property_type=flat&construction_date=pre_1914&bedrooms=3&bathrooms=1&finish_quality=below_average&outdoor_space=garden&off_street_parking=0

For a full UK postcode and a range of required parameters relating to a particular UK property, returns an estimated sale value (with +/- margin of error) for that property. The only available AVM in the UK that uses market £/sqft data as part of the valuation.

Input

Example

https://api.propertydata.co.uk/valuation-sale?key={API_KEY}&postcode=OX41YB&internal_area=828&property_type=flat&construction_date=pre_1914&bedrooms=3&bathrooms=1&finish_quality=below_average&outdoor_space=garden&off_street_parking=0

For one of the following:

• A UK postcode (full, district or sector)
• The latitude & longitude co-ordinates of a location in the UK
• A what3words address in the UK
• A town or city in the UK

This endpoint returns average property yields from the smallest radius at which there is reasonable data.

If a town name is the supplied input, for larger towns this endpoint will take a sample from the center of the town. It will be indicated in the response where this has happened with the sample_from_town_center field.

Input

Example

https://api.propertydata.co.uk/yields?key={API_KEY}&postcode=W149JH&bedrooms=2

Get information about your API account credit usage including:

• API credits used
• API credits remaining
• Account API credit limit
• Account API credits renewal timestamp

Input

Example

https://api.propertydata.co.uk/account/credits?key={API_KEY}

A summary of your previous Land Registry and Site Plan document purchases, with download links where available

Input

Example

https://api.propertydata.co.uk/account/documents?key={API_KEY}&type=all&title=GR514442&date=2024-01-01