Error reference

All the possible errors returned by the PropertyData API, with further explanation and recommended actions:

CodeMessageExplanation / recommended action
X01Invalid API methodCheck the API method is spelled correctly and that it follows immediately after the base URL, e.g. https://api.propertydata.co.uk/method-name. If in doubt, try with the example URL from the documentation first.
X02Missing input: keyYou have not supplied an API key. Every PropertyData API call requires a key, in the querystring using the variable 'key'. If you're logged in to PropertyData, the example URLs in the API documentation are automatically populated with your API key.
X03Invalid input: keyYou supplied an API key, but it was not recognised. Check that your key is correct. Note that this is the error you would receive if you regenerated your API key in your account home, but were trying to use the old key in your application.
X04Monthly plan limit exceeded: N callsYou have reached your API plan call limit. Note that calls limits are reset at 00:01 on the first day of each calendar month. Consider upgrading your plan.
X05Account associated with API key cancelled or card declinedThe PropertyData account associated with the API key you supplied has been cancelled or had it's card declined. Login and reactivate the account if you wish to continue using the PropertyData API.
X06Missing input: postcodeYou have not supplied a postcode. All API methods except 'stamp-duty' require a full UK postcode, in the querystring using the variable 'postcode'.
X07Invalid input: postcodeThe postcode you supplied was not recognised as a full UK postcode. Most of the time this means the postcode is not valid, although it can also mean the postcode is newly allocated. Try a different postcode.
X08Insufficient data foundNot enough relevant data points could be found to return analytics. See 'Data collection logic' in Getting started to understand more.
X09Uncaught exceptionAn unexpected error occuring in processing your API request. Please contact us, copying and pasting your API request URL.
X10Full postcode required for this methodYou cannot use a postcode district or sector on this method, please use only a full UK postcode.
X11Method only available in [COUNTRIES]Due to source data limitations, some PropertyData API methods are only available in England or England & Wales. See the Getting started page for a breakdown.
X12Invalid points: min 15, max 100If you supply the number of points to analyse, this must be between 15 and 100. Otherwise the default of 20 will be used.
X13Free trial limit exceeded: 500 callsDuring your API free trial you can only make 500. Please manually start your first month.
X14Key throttled: last call less than two seconds agoOur terms and conditions currently ask that you make no more than one call per two second period. If you receive this message, you are calling the API too fast. Please throttle your requests.
SMScheduled server maintenanceVery occasionally we take the API down for scheduled server upgrades and/or maintenance. This typically doesn't take more than one hour.
102Invalid filter: bedroomsThe value you supplied in the 'bedrooms' filter variable was not valid. Valid values are 0, 1, 2, 3, 4, 5.
103Invalid filter: typeThe value you supplied in the 'type' filter variable was not valid. Consult the valid types list.
401Value provided not recognised or out of range (1 - 10000000)Stamp duty can only be calculated for prices of £1 to £10,000,000. Enter an integer in this range.
402Country provided not recognisedThe value you supplied in the 'country' variable was not valid. Consult the countries list or remove the country value to use 'england' as default.
403A transaction cannot be both for a first-time buyer and an additional propertyYou entered 1 for both addtional rate stamp duty and first-time property. It is not possible for a transaction to be made both a first-time buyer and as an additional property.
404Mode provided not recognisedThe value you supplied for this field was not valid. Valid values for this field are:
investment, primary, first_time, non_resi
501Unable to identify councilWe couldn't figure out the council from the valid postcode provided. This should not happen - please contact us us and let us know the postcode, and we will fix this.
602Invalid input: decision_ratingValid values for decision_rating are 'positive', 'negative' or 'neutral'
603Invalid input: max_age_decisionThe valid input for max_age_decision is an integer, minimum 1, maximum 1000.
604No planning applications matching filterPlanning applications were found in this area, but none that matched your filters.
605Invalid input: max_age_updateThe valid input for max_age_update is an integer, minimum 1, maximum 1000.
701Missing input: field_nameThe named field is missing. All fields are required for valuations.
702Invalid input: field_nameThe named field is invalid. Consult the API documentation and accepted valuation options list and correct your inputs.
801Title not foundUnable to find a title number matching the title number you provided.
901Invalid filter: bedroomsThe value you supplied in the 'bedrooms' filter variable was not valid. Valid values are 0, 1, 2, 3, 4, 5.
902Invalid filter: typeThe value you supplied in the 'type' filter variable was not valid. Consult the valid types list.
903Invalid filter: classThe value you supplied in the 'class' filter variable was not valid. Valid values are 'old_stock' or 'new_build'.
904Invalid filter: tenureThe value you supplied in the 'tenure' filter variable was not valid. Valid values are 'freehold' or 'leasehold'.
905Invalid filter: max_ageThe value you supplied in the 'max_age' filter variable was not valid. Valid values are integers between 3 and 60 inclusive.
1001Not a Greater London postcodeThe PTAL method is only available for Greater London postcodes, since it is a Transport for London metric.
1101Missing input: listYou did not provide a property list. This is required. Consult the property lists list.
1102Invalid input: listThe 'list' provided does not match one of our lists. Consult the property lists list.
1103Region provided not recognisedThe value you supplied in the 'region' variable was not valid. Consult the regions list.
1104Invalid input: radiusThe value you supplied in the 'radius' variable was not valid. Radius must be an integer between 1 and 200 inclusive (miles)
1105Invalid input: resultsThe value you supplied in the 'results' variable was not valid. Results must be an integer between 10 and 500 inclusive
1201Unable to find any schools nearbyWe couldn't find any schools near this postcode.
1202Invalid filter: phaseInvalid filter for phase used. Accepted options are: Primary, Nursery, PRU, Secondary, Special
1301Unable to find any restaurants nearbyWe couldn't find any restaurants near this postcode.
1401Invalid input: finish qualityThe value you supplied for finish quality is invalid. Allowed values are 'premium', 'medium' or 'economy'.
1501Missing input: bedroomsYou did not provide a number of bedrooms. This field is required for calculating LHA rate.
1502Invalid filter: bedroomsThe value you supplied in the 'bedrooms' filter variable was not valid. Valid values for this method are 1, 2, 3, 4.
1601Invalid filter: gradeThe value you supplied in the 'grade' filter variable was not valid. Valid values for this method are:
I, II* or II
1602Invalid filter: listed_afterThe value you supplied in the 'listed_after' filter variable was not valid. This value needs to be a valid year in YYYY format, eg 1975.
1701Missing input: property_idYou did not provide the id for a property, as returned by the /sourced-properties API method.
1702Invalid input: property_idThe property_id value you supplied was not in the expected format. The property_id parameter should match an id for a property as returned by the /sourced-properties API method.
1703Property (ID: {property_id}) not foundThe property could not be found on our Sourcing lists. Either this property has been removed from the market or there is an error in the provided property_id.
1801Missing input: field_nameThe named field is missing. All fields are required for development calculation.
1802Invalid input: field_nameThe named field is present but is not valid. This field must be a numeric value without any unit prefix or suffix, eg: 100000.
1803Invalid input: project_typeThe value you supplied for this field was not valid. Valid values for this field are:
refurbish, demolition
1804Invalid input: property_typeThe value you supplied for this field was not valid. Valid values for this field are:
house, block_of_flats
1805Invalid input: finish_qualityThe value you supplied for this field was not valid. Valid values for this field are:
premium, medium, basic
1901Missing input: titleYou did not provide the title input. A valid land title number is required for this method
1902Invalid input: titleThe land title number you provided for this method is not valid. Land title numbers can be found using the /freehold-titles API method
1903Buildings could not be analysed for this titleWe are unable to provide a building analysis for this title plot
2000Use class unknownWe are unable to determine the planning use class for this land registry title
2100UPRN not foundWe are unable to find a UPRN record with the provided UPRN

How PropertyData can help you

I'm an investor I'm a developer I'm an agent

Limit reached

Sorry, you've reached your monthly search limit. Upgrade your account today for more searches!

Upgrade

Upgrade to download PDFs

There are many places in PropertyData to export data as well-formatted PDF files, including Local Data, Plot Map, Valuations, property reports and more.

Basic


No PDFs

Pro


Download PDFs

Max


Download PDFs


Branded PDFs

Start your free trial now

Transparent data promise

Where does the raw data come from?

Property listings seen on rightmove.co.uk, zoopla.co.uk and onthemarket.com.

How often is the data updated?

The data is updated in near real-time.

What time period does the data cover?

This is a real-time market snapshot - the data covers currently listed properties. Once properties are removed from the portal, they are soon removed from this tab.

How is the raw data processed?

Duplicates from multiple sources are matched and reconciled as far as possible. Listings with obvious errors, where price or number or bedrooms appear out of range, are discarded.

What are the statistics used?

Averages shown are the interquartile mean, a type of average that is insensitive to outliers while being its own distinct parameter. The 80% range means that 80% of the listed properties fall inside this range.

Where does the raw data come from?

Property listings seen on rightmove.co.uk, zoopla.co.uk and onthemarket.com.

How do you know the square footage of properties?

We use proprietary technology to read the square footage of properties from agent floorplans. Although we cannot determine the square footage for all properties, we can usually get sufficient coverage. Agents are sometimes known to inflate square footage, and this should be borne in mind as a weakness of this data.

How often is the data updated?

The data is updated in near real-time.

What time period does the data cover?

This is a real-time market snapshot - the data covers currently listed properties. Once properties are removed from the portal, they are soon removed from this tab.

How is the raw data processed?

Duplicates from multiple sources are matched and reconciled as far as possible. Listings with obvious errors, where price or number or bedrooms appear out of range, are discarded.

What are the statistics used?

The average shown is the interquartile mean, a type of average that is insensitive to outliers while being its own distinct parameter. The 80% range means that 80% of the listed properties fall inside this range.

Where does the raw data come from?

Property "price paid" data provided by the Land Registry.

How often is the data updated?

Once per month when released by the Land Registry, typically towards the end of each calendar month covering up to the end of the previous calendar month.

What time period does the data cover?

You can customise the time period using the filter at the top of the view. The default time period is up to 9 months back from today's date. The latest data covers the period up to 2022-05-31, although some sales that took place before this date may still be added in the coming months.

How is the raw data processed?

No additional processes are applied to this data.

What are the statistics used?

Averages shown are the interquartile mean, a type of average that is insensitive to outliers while being its own distinct parameter. The 80% range means that 80% of the listed properties fall inside this range.

Where does the raw data come from?

Property "price paid" data provided by the Land Registry, and Energy Performance Certificate (EPC) data provided by Ministry of Housing, Communities & Local Government.

How do you know the square footage of properties?

We match the Land Registry data to EPC data provided by the MCHLG. Due to the fact that not all properties sold have had an EPC and vagaries of addressing in the UK, we are not able to determine the square footage of all properties, but we can usually get sufficient coverage.

How often is the data updated?

The private paid data is updated once per month when released by the Land Registry, typically towards the end of each calendar month covering up to the end of the previous calendar month. The energy performance certificate database is updated monthly.

What time period does the data cover?

You can customise the time period using the filter at the top of the view. The default time period is up to 9 months back from today's date. The latest data covers the period up to 2022-05-31, although some sales that took place before this date may still be added in the coming months.

How is the raw data processed?

No additional processes are applied to this data.

What are the statistics used?

The average shown is the interquartile mean, a type of average that is insensitive to outliers while being its own distinct parameter. The 80% range means that 80% of the listed properties fall inside this range.

Where does the raw data come from?

Property listings seen on rightmove.co.uk, zoopla.co.uk and onthemarket.com.

How often is the data updated?

The data is updated in near real-time.

What time period does the data cover?

This is a real-time market snapshot - the data covers currently listed properties. Once properties are removed from the portal, they are soon removed from this tab.

How is the raw data processed?

Duplicates from multiple sources are matched and reconciled as far as possible. Listings with obvious errors, where price or number or bedrooms appear out of range, are discarded.

What are the statistics used?

The average shown is the interquartile mean, a type of average that is insensitive to outliers while being its own distinct parameter. The 80% range means that 80% of the listed properties fall inside this range.

Where does the raw data come from?

Room let listings on SpareRoom, the UK's biggest room letting website.

How often is the data updated?

The data is updated in near real-time.

What time period does the data cover?

This is a real-time market snapshot - the data covers currently listed properties. Once properties are removed from SpareRoom, they are soon removed from this tab.

How is the raw data processed?

Listings with obvious errors, where price or number or bedrooms appear out of range, are discarded.

What are the statistics used?

The average shown is the interquartile mean, a type of average that is insensitive to outliers while being its own distinct parameter. The 80% range means that 80% of the listed properties fall inside this range.

Where does the raw data come from?

Property listings seen on rightmove.co.uk, zoopla.co.uk and onthemarket.com.

How often is the data updated?

The data is updated in near real-time.

What time period does the data cover?

This is a real-time market snapshot - the data covers currently listed properties. Once properties are removed from the portal, they are soon removed from this tab.

How is the raw data processed?

Duplicates from multiple sources are matched and reconciled as far as possible. Listings with obvious errors, where price or number or bedrooms appear out of range, are discarded. Yields are calculated by comparing only properties with the same number of bedrooms, e.g. 3-bedroom properties for rent with 3-bedroom properties for sale.

What is the yield calculation used?

The calculation used is (average_weekly_asking_rent * 52 / average_asking_price), expressed as a percentage. It is a top-line gross yield, meaning no expenses are considered.

What are the statistics used?

The average shown is the interquartile mean, a type of average that is insensitive to outliers while being its own distinct parameter. The 80% range means that 80% of the listed properties fall inside this range.

Where does the raw data come from?

Property listings seen on rightmove.co.uk, zoopla.co.uk and onthemarket.com.

How often is the data updated?

The data is updated in near real-time.

What time period does the data cover?

This is a real-time market snapshot - the data covers currently listed properties. Once properties are removed from Zoopla, Rightmove or Spareroom, they are soon removed from this tab.

How is the raw data processed?

Duplicates from multiple sources are matched and reconciled as far as possible. Yields are calculated by comparing only properties with the same number of bedrooms, e.g. 3-bedroom properties for rent with 3-bedroom properties for sale. For the SpareRoom data, hypothetical properties consisting of two to six average double rooms with shared bathrooms are used to derived average rent. For all sources, listings with obvious errors, where price or number or bedrooms appear out of range, are discarded.

What is the yield calculation used?

The calculation used is (average_weekly_asking_rent * 52 / average_asking_price), expressed as a percentage. It is a top-line gross yield, meaning no expenses are considered.

What are the statistics used?

The average shown is the interquartile mean, a type of average that is insensitive to outliers while being its own distinct parameter. The 80% range means that 80% of the listed properties fall inside this range.

Where does the raw data come from?

Property "price paid" data provided by the Land Registry.

How often is the data updated?

Once per month when released by the Land Registry, typically towards the end of each calendar month covering up to the end of the previous calendar month.

Zoopla Zed-index

What time period does the data cover?

The data covers transactions in the last six years

How is the raw data processed?

No additional processes are applied to this data.

What are the statistics used?

The average shown is the interquartile mean, a type of average that is insensitive to outliers while being its own distinct parameter. The 80% range means that 80% of the listed properties fall inside this range.

Where does the raw data come from?

Property listings seen on rightmove.co.uk, zoopla.co.uk and onthemarket.com.

How often is the data updated?

The listings data is updated in near real-time. The Land Registry data is updated once per month when released, typically towards the end of each calendar month covering up to the end of the previous calendar month.

What time period does the data cover?

The price paid data shown goes back to January 2015. The listings data is a real-time market snapshot - the data covers currently listed properties. Once properties are removed from the portal, they are soon removed from this tab.

How is the raw data processed?

Duplicates from multiple sources are matched and reconciled as far as possible. Listings with obvious errors, where price or number or bedrooms appear out of range, are discarded.

What are the calculations used?

Average sales per month are for the last 3 finalised months. Turnover is average sales per month divided by total for sale. Inventory is 100 divided by turnover.

Where does the raw data come from?

Property listings seen on rightmove.co.uk, zoopla.co.uk and onthemarket.com.

How often is the data updated?

The listings data is updated in near real-time. The Land Registry data is updated once per month when released, typically towards the end of each calendar month covering up to the end of the previous calendar month.

What time period does the data cover?

This is a real-time market snapshot - the data covers currently listed properties. Once properties are removed from the portal, they are soon removed from this tab.

How is the raw data processed?

Duplicates from multiple sources are matched and reconciled as far as possible. Listings with obvious errors, where price or number or bedrooms appear out of range, are discarded.

Where does the raw data come from?

We receive data on the extent and corporate ownership of all land titles in England & Wales from the Land Registry.

How often is the data updated?

The data is updated once per month when released, typically in the first few days of each calendar month.

What time period does the data cover?

This is an ownership snapshot - the data represents ownership as recorded by the Land Registry at the last monthly export.

How is the raw data processed?

No additional processes are applied to this data.

Where does the raw data come from?

We source different expert forecasts Savills, Knight Frank, OBR

How often is the data updated?

The data is updated annually when new forecasts are released, typically towards the beginning of the year.

How is the raw data processed?

We calculate a consensus forecast using a simple mean average.