AccuVal is an AI based valuation platform for properties in the United Kingdom. It can be accessed interactively with any modern web browser, or programmatically using a REST API tool. Currently, AccuVal provides estimates for the property value, rent and liquidity score. This repo explains how AccuVal can be accessed via API with examples.
UPRN stands for Unique Property Reference Number. It’s becoming the de-facto to reference properties in the UK. As the name suggests, UPRN is unique for each property. However, please keep in mind that not all properties have UPRN assigned in all databases.
To value a property using it’s UPRN code, the following example can be used from the command-line:
curl -H "apikey: replace-with-your-key" "https://accuval.co.uk/api/valuation/price/1.0/?uprn=202215263"
Which would return:
{"Type": "Flat/Maisonette", "NUMBER_HABITABLE_ROOMS": 4, "TOTAL_FLOOR_AREA": 72, "CURRENT_ENERGY_RATING": "B", "POTENTIAL_ENERGY_RATING": "B", "CONSTRUCTION_AGE_BAND": "2012 Onwards", "Duration": "Leasehold", "New": "No", "Condition": "Average", "Price": 553430, "Confidence": "High confidence", "POSTCODE": "HA9 0FR", "ADDRESS": "Flat 1 Archery Court, 31, Olympic Way"}
in JSON format. Obviously, the UPRN is required.
To get the rental value estimate for the property, the following example can be used:
curl -v -H "apikey: replace-with-your-key" "https://accuval.co.uk/api/valuation/rent/1.0/?uprn=202215263"
To get the liquidity score for the property, the following example can be used:
curl -v -H "apikey: replace-with-your-key" "https://accuval.co.uk/api/valuation/liquidity/1.0/?uprn=202215263&price=553430"
Which would return:
{"POSTCODE": "HA9 0FR", "Type": "Flat", "TOTAL_FLOOR_AREA": 72, "LIQUIDITY": 0.5601287159056084}
Please contact us for pricing and API keys.
If UPRN is unavailable or unknown, AccuVal can still value properties based on their postcodes and basic information. This method is also useful to value properties that have changed or do not exist (yet)!
To value a property using it’ details, the following example can be used:
curl -H "apikey: replace-with-your-key" "https://accuval.co.uk/api/valuation/price/1.0/?postcode=HA9+0FR&address=Flat+1+Archery+Court,+31,+Olympic+Way&type=Flat/Maisonette&rooms=4&area=72&uom=m&epc_current=B&epc_potential=B&age=2012+Onwards&duration=Leasehold&new=No&condition=Average"
Which would return:
{"Type": "Flat/Maisonette", "NUMBER_HABITABLE_ROOMS": 4, "TOTAL_FLOOR_AREA": 72, "CURRENT_ENERGY_RATING": "B", "POTENTIAL_ENERGY_RATING": "B", "CONSTRUCTION_AGE_BAND": "2012 Onwards", "Duration": "Leasehold", "New": "No", "Condition": "Average", "Price": 553430, "Confidence": "High confidence", "POSTCODE": "HA9 0FR", "ADDRESS": "Flat 1 Archery Court, 31, Olympic Way"}
To get the rental value estimate for the property, the following example can be used:
curl -H "apikey: replace-with-your-key" "https://accuval.co.uk/api/valuation/rent/1.0/?postcode=HA9+0FR&address=Flat+1+Archery+Court,+31,+Olympic+Way&type=Flat/Maisonette&rooms=4&area=72&uom=m&epc_current=B&epc_potential=B&age=2012+Onwards&duration=Leasehold&new=No&condition=Average"
Which would return:
{"Type": "Flat/Maisonette", "NUMBER_HABITABLE_ROOMS": 4, "TOTAL_FLOOR_AREA": 72, "CURRENT_ENERGY_RATING": "B", "POTENTIAL_ENERGY_RATING": "B", "CONSTRUCTION_AGE_BAND": "2012 Onwards", "Duration": "Leasehold", "New": "No", "Condition": "Average", "Confidence": "High confidence", "POSTCODE": "HA9 0FR", "ADDRESS": "Flat 1 Archery Court, 31, Olympic Way", "Rent": 2075}
To get the liquidity score for the property, the following example can be used:
curl -v -H "apikey: replace-with-your-key" "https://accuval.co.uk/api/valuation/liquidity/1.0/?postcode=HA9+0FR&type=Flat/Maisonette&area=728&price=553430"
Which would return:
{"POSTCODE": "HA9 0FR", "Type": "Flat", "TOTAL_FLOOR_AREA": 728, "LIQUIDITY": 0.5601287159056084}
A valid UK postcode, i.e. HA9 0FR. Currently only England and Wales are supported. Please note that whitespaces aren't allowed, so in the example above using curl, whitespaces are replaced with the '+' symbol.
- The property type, which can one of:
Flat/MaisonetteTerraced/End-of-TerraceSemi-DetachedDetached/Bungalow
The total floor area. This can be obtained from the EPC certificate.
The total number of habitable rooms. This includes bedrooms, living rooms and receptions. Kitchens and bathrooms are not considered habitable rooms and should not be included. Must be a positive integer. defaults to 3 if missing.
The first line address.
Unit of measure for the area, can be:
msquare meters (default)fsquare feet
The current energy rating. This can be obtained from the EPC certificate. Possible values:
ABCD(default)EF
The potential energy rating. This can be obtained from the EPC certificate. Possible values:
ABC(default)DEF
The construction age band. Possible values:
Before 19001900-19291930-1949(default)1950-19661967-19751976-19821983-19901991-19951996-20022003-20062007-20112012 Onwards
The type of tenure for the property. Possible values:
LeaseholdFreehold
If missing, defaults to Leasehold for Flat/Maisonette, otherwise Freehold
Whether the property is a new build (i.e. no prior records with Land Registry). Possible values:
YesNo(default)
The overall condition of the property in relations to similar properties in the area. Possible values:
OutstandingAbove AverageAverage(default)Below AveragePoor
The Liquidity Score requires the price to be provided in the request.