Access to planning applications harvested from authorities in Surrey County via a consistent API.
Details of the API can be found below. A simple means of embedding a map within any web page is also provided, details of which can be found on the maps page.
Web API to retrieve applications in GeoJSON format optionally filtering and sorting on one of the fields described below.
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:
/developmentcontrol/0.1/applications/search?
Applications published by a given authority identified by GSS code:
/developmentcontrol/0.1/applications/gsscode/<code>?
Applications with a given application status code:
/developmentcontrol/0.1/applications/status/<status>?
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 application/javascript and will include the appropriate JSONP padding, otherwise the response will be plain JSON with a content-type of application/json.
Parameter name: status
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 |
Live - in the process of being decided |
withdrawn |
Withdrawn |
decided |
Decided |
appeal |
Appeal - in the process of being decided via a non-determination appeal |
called_in |
Called in - in the process of being considered by the Secretary of State |
referred_to_sos |
Referred to SoS - in the process of being considered by the Secretary of State |
invalid |
Invalid - requires something to happen to it before it can be decided |
not_ours |
Not ours - belong to other planning authorities |
registered |
Registered - received but not yet been processed and validated |
Live and decided applications
status=live,decided
Parameter name: gsscode
One or more GSS codes. When specified via the query string multiple GSS code values are comma separated.
Each authority has a unique (Government Statistical Service) GSS code assigned by the ONS (Office for National Statistics). A complete list of GSS codes can be found here via the ONS Geoportal.
A nine character GSS code.
Current supported GSS codes:
| GSS Code | Authority |
|---|---|
| E07000207 | Elmbridge |
| E07000208 | Epsom and Ewell |
| E07000209 | Guildford |
| E07000210 | Mole Valley |
| E07000211 | Reigate and Banstead |
| E07000212 | Runnymede |
| E07000213 | Spelthorne |
| E07000214 | Surrey Heath |
| E07000215 | Tandridge |
| E07000216 | Waverley |
| E07000217 | Woking |
| E10000030 | Surrey County |
Surrey Heath and Mole Valley
gsscode=E07000214,E07000210
Parameter names: casedate, decisiontargetdate, decisionnoticedate, decisiondate, publicconsultationstartdate, publicconsultationenddate
| Value | Description |
|---|---|
last_7_days |
Last 7 days including the current day |
last_14_days |
Last 14 days including the current day |
last_30_days |
Last 30 days including the current day |
last_90_days |
Last 90 days including the current day |
Applications with a case date with in the last 7 days:
casedate=last_7_days
Applications with a publicconsultationstartdate within the last 30 days:
publicconsultationstartdate=last_30_days
The bounding box for search for applications in WGS84 format.
Parameter name: bbox
A bounding box is of the form: xmin, ymin, xmax, ymax
Surrey Heath District
bbox=-0.78,51.25,-0.53,51.4
Results can be ordered by one of the following fields:
| Field | Description |
|---|---|
| status | Application status code (alphabetically) |
| casedate | Case date (on date) |
An optional sort order can also be specified:
| Value | Description |
|---|---|
| asc | Sort assending (a to z, 9 to 0) |
| desc | Decending (z to a, 9 to 0) |
Order by case date most recent first:
orderby=status&sortorder=desc
"JSONP or "JSON with padding" is a communication technique used in JavaScript programs running in web browsers to request data from a server in a different domain" - https://en.wikipedia.org/wiki/JSONP
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.
callback=foo
All of the following requests return live applications for Surrey Heath District ordered by case date:
/developmentcontrol/0.1/applications/search?status=live&gsscode=E07000214&orderby=casedate
/developmentcontrol/0.1/applications/gsscode/E07000214?status=live&orderby=casedate
/developmentcontrol/0.1/applications/status/live?orderby=casedate&gsscode=E07000214
Data accessible from this API is made available for non-commercial and personal use. It is licensed under the Public Sector Mapping Agreement.