Access to planning applications harvested from authorities in Surrey County via a consistent API.
The API is versioned to allow changes in future, requests should always be made against a specific version of the API.
All endpoints allow the results to be filtered and sorted via query string parameters.
Endpoints for the current version of the API are shown below:
Search for applications passing filter parameters via the query string:
Applications published by a given authority identified by GSS code:
Applications with a given application status code:
The response of the API will be a list of applications containing all fields in the national planning schema as a GeoJSON FeatureCollection. If a
callback parameter is included then the response will have a content-type of
One or more application status constants. When specified via the query string multiple status values are comma separated.
The national planning schema provides a fixed set of application status values listed below together with the constant value used with this API:
|API Parameter value||National Planning Schema value|
||Live - in the process of being decided|
||Appeal - in the process of being decided via a non-determination appeal|
||Called in - in the process of being considered by the Secretary of State|
||Referred to SoS - in the process of being considered by the Secretary of State|
||Invalid - requires something to happen to it before it can be decided|
||Not ours - belong to other planning authorities|
||Registered - received but not yet been processed and validated|
Live and decided applications
One or more GSS codes. When specified via the query string multiple GSS code values are comma separated.
A nine character GSS code.
Current supported GSS codes:
|E07000208||Epsom and Ewell|
|E07000211||Reigate and Banstead|
Surrey Heath and Mole Valley
||Last 7 days including the current day|
||Last 14 days including the current day|
||Last 30 days including the current day|
||Last 90 days including the current day|
Applications with a case date with in the last 7 days:
Applications with a publicconsultationstartdate within the last 30 days:
The bounding box for search for applications in WGS84 format.
A bounding box is of the form:
xmin, ymin, xmax, ymax
Surrey Heath District
Results can be ordered by one of the following fields:
|status||Application status code (alphabetically)|
|casedate||Case date (on date)|
An optional sort order can also be specified:
|asc||Sort assending (a to z, 9 to 0)|
|desc||Decending (z to a, 9 to 0)|
Order by case date most recent first:
In order to make a JSONP request simply pass a
callback query string parameter specifying the name of the callback. Libraries such as jQuery provide support for JSONP, see jQuery.getJSON for more information.
All of the following requests return live applications for Surrey Heath District ordered by case date:
Data accessible from this API is made available for non-commercial and personal use. It is licensed under the Public Sector Mapping Agreement.