Skip to content

API Reference

Data Model

Properties

The core concept of the PropEco API is a Property to which we associate various datasets. Properties are identified by a Unique Property Reference Number (or UPRN).

For UPRN-based searches, location-based assessments use the coordinate associated with the supplied UPRN to determine distances to points, features or zones of interest, such as conservation areas, flood risk zones or EV charging points.

This means that, in some cases, part of a property or its surrounding land may fall within an area affected by a risk or restriction even though the coordinate associated with its UPRN does not.

Where appropriate, API responses therefore provide distances to nearby features and zones of interest, allowing users to apply their own buffers when carrying out property-based assessments.

Boundary-based searches using supplied geometries are available on request. Please contact info@propeco.io to find out more.

Coordinate Systems

Throughout the PropEco API, geographical locations of properties and other features are provided, and in some cases used in queries. We use two different coordinate systems to reference geographical locations:

Here is an example location as seen from our Property Data endpoint:

{
    "uprn": "1",
    "x_coord": 358260.66,
    "y_coord": 172796.5,
    "latitude": 51.4526008,
    "longitude": -2.602075,
    ...
}

For some features, azimuth_degrees is provided. This represents the initial bearing from the property or location to the feature, measured clockwise from north.

Coverage

At present, the API covers properties and locations in England, Scotland and Wales.

Note that some of the underlying data sources are provided at a national or even regional level and so we cannot guarantee that the same amount of information will be available for every property or location.

Moreover, the format of some datasets (e.g., flood risk assessments and energy performance certificates) varies between Scotland, England and Wales. Where this is the case, it is reflected in the API response.

Sources & attribution

The API combines PropEco's proprietary data and analysis with data sourced from a range of third parties.

Where applicable, details of the underlying data sources, licences and required attribution are provided on the relevant endpoint pages.

Updates

We aim to incorporate any updates to underlying data sources within 48 hours.

Development and Changes

PropEco regularly adds new datasets, assessments and functionality to the API. Changes that may affect existing integrations will be communicated to customers in advance where appropriate.