Surrey Planning Hub

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.

API

Web API to retrieve applications in GeoJSON format optionally filtering and sorting on one of the fields described below.

Endpoints

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

Search for applications passing filter parameters via the query string:

/developmentcontrol/0.1/applications/search?

Single Authority

Applications published by a given authority identified by GSS code:

/developmentcontrol/0.1/applications/gsscode/<code>?

Single status code

Applications with a given application status code:

/developmentcontrol/0.1/applications/status/<status>?

Response

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.

Filter by

Application status

Parameter name: status

One or more application status constants. When specified via the query string multiple status values are comma separated.

Values

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
Query string

Live and decided applications

status=live,decided

GSS code

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.

Values

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
Query string

Surrey Heath and Mole Valley

gsscode=E07000214,E07000210

Date range

Parameter names: casedate, decisiontargetdate, decisionnoticedate, decisiondate, publicconsultationstartdate, publicconsultationenddate

Values
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
Query string

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

Bounding box

The bounding box for search for applications in WGS84 format.

Parameter name: bbox

Values

A bounding box is of the form: xmin, ymin, xmax, ymax

Query string

Surrey Heath District

bbox=-0.78,51.25,-0.53,51.4

Order by

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)

Query string

Order by case date most recent first:

orderby=status&sortorder=desc

JSONP

"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.

Query string

callback=foo

Example API requests

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

License

Data accessible from this API is made available for non-commercial and personal use. It is licensed under the Public Sector Mapping Agreement.