National public view

Working draft

The national public view sets out the planning application data that planning authorities are expected to publish as open data.

It includes every listed field for each included record, except that development-scale applies only to full and outline planning applications.

Find out more about the national public view:

Datasets to publish

Planning application: Publish all records.
Site: Publish all records.
Decision notice: Publish all records.
Planning condition: Publish all records.
Decision condition: Publish all records.
Section 106 agreement: Publish all records.
Planning application document: Include only documents the planning authority has decided may appear on the public register.
Planning permission timeline: Include only permission process events selected for the national public view.

Planning application

Records of applications submitted to planning authorities

Publish all records in this dataset.

Field	Description	Requirement level	Data type and cardinality	Related information
Reference (`reference`)	the reference used for the planning application, for example 2025/1674	`MUST`	`string` 1
Name (`name`)	A plain-language label for the planning application so it can be identified without relying on its reference	`SHOULD`	`string` 1
Description (`description`)	the description of the proposed development	`MUST`	`string` 1
Application types (`application-types`)	one or more application types that the application covers	`MUST`	`enum` n	Allowed values are in the application-type codelist.
Site (`site`)	the reference to the related site	`MUST`	`string` 1	Refers to the site dataset.
Received date (`received-date`)	the date the planning authority received the application	`MUST`	`datetime` 1
Planning authority (`planning-authority`)	Identifier of the planning authority that received this planning application	`MUST`	`enum` 1	Allowed values are in the planning-authority codelist.
Development scale (`development-scale`)	the local planning authority's classification of a full or outline planning application by development scale, where applicable. Either major or minor Only for full and outline planning applications.	`SHOULD`	`enum` 1	Allowed values are in the development-scale codelist.
Planning performance agreement (`planning-performance-agreement`)	whether the application was subject to a Planning Performance Agreement	`MUST`	`boolean` 1
Withdrawn date (`withdrawn-date`)	the date the planning application was withdrawn	`SHOULD`	`datetime` 1
Linked applications (`linked-applications`)	references to earlier applications this application directly links to	`MUST`	`string` n	Refers to the planning-application dataset.
Document URL (`document-url`)	a URL to the completed application form published by the planning authority, where available	`SHOULD`	`url` 1
Documentation URL (`documentation-url`)	a URL to the planning authority page where the completed application form or supporting application information can be accessed, where available	`MUST`	`url` 1
Notes (`notes`)	Optional notes that provide additional context about the planning application	`MAY`	`string` 1

Back to list of datasets

Site

Records of development sites linked to planning applications

Publish all records in this dataset.

Field	Description	Requirement level	Data type and cardinality	Related information
Reference (`reference`)	the reference for the site	`MUST`	`string` 1
Name (`name`)	a plain-language name for the site so it can be referenced in discussions and reports	`SHOULD`	`string` 1
Address Text (`address-text`)	a plain-language address or description that helps identify the site location	`MUST`	`string` 1
Postcode (`postcode`)	postcode for the site, where one is available	`SHOULD`	`string` 1
UPRNs (`uprns`)	UPRNs for existing properties and premises within the site boundary, where known	`SHOULD`	`string` n
USRNs (`usrns`)	USRNs for streets associated with the site, where known	`SHOULD`	`string` n
Geometry (`geometry`)	the boundary for the site	`MUST`	`multipolygon` 1

Back to list of datasets

Decision notice

The decision notice dataset records the issued decision for a planning application

Publish all records in this dataset.

Field	Description	Requirement level	Data type and cardinality	Related information
Reference (`reference`)	the reference for the decision notice	`MUST`	`string` 1
Planning application (`planning-application`)	the reference for the planning application the decision notice is for	`MUST`	`string` 1	Refers to the planning-application dataset.
Decision (`decision`)	the decision outcome for the planning application	`MUST`	`enum` 1	Allowed values are in the decision codelist.
Decision date (`decision-date`)	the date the decision notice was issued	`MUST`	`datetime` 1
Organisation (`organisation`)	the organisation issuing the decision notice	`MUST`	`enum` 1	Allowed values are in the organisations codelist.
Decision maker (`decision-maker`)	the category of person or body that formally made the decision	`MUST`	`enum` 1	Allowed values are in the decision-maker codelist.
Planning officer recommendation (`planning-officer-recommendation`)	the recommendation made by the planning officer for this application	`SHOULD`	`enum` 1	Allowed values are in the decision codelist.
Document URL (`document-url`)	the URL to the published decision notice	`SHOULD`	`url` 1
Documentation URL (`documentation-url`)	the URL of the page where the decision notice can be found	`MUST`	`url` 1
Notes (`notes`)	Optional notes that provide additional context about the decision notice	`MAY`	`string` 1

Back to list of datasets

Planning condition

Records of individual planning conditions

Publish all records in this dataset.

Field	Description	Requirement level	Data type and cardinality	Related information
Reference (`reference`)	a reference for the planning condition	`MUST`	`string` 1
Name (`name`)	a plain-language label for the condition	`SHOULD`	`string` 1
Description (`description`)	the text of the condition that must be met	`MUST`	`string` 1
Reason (`reason`)	the reason for imposing the condition	`MUST`	`string` 1
Organisation (`organisation`)	the organisation that maintains the condition clause	`MUST`	`enum` 1	Allowed values are in the organisations codelist.

Back to list of datasets

Decision condition

Records each planning condition attached to a decision so the decision record reflects all legal requirements

Publish all records in this dataset.

Field	Description	Requirement level	Data type and cardinality	Related information
Reference (`reference`)	the reference for the decision condition	`MUST`	`string` 1
Decision notice (`decision-notice`)	the reference for the decision notice this condition is attached to	`MUST`	`string` 1	Refers to the decision-notice dataset.
Planning condition (`planning-condition`)	the reference for the linked planning condition record	`MUST`	`string` 1	Refers to the planning-condition dataset.
Requested by (`requested-by`)	identifier of the body requesting the condition	`Not specified`	`enum` 1	Allowed values are in the organisations codelist.
Discharged by (`discharged-by`)	identifier of the decision notice discharging the condition	`MUST`	`string` 1	Refers to the decision-notice dataset.

Back to list of datasets

Section 106 agreement

Records of section 106 agreements linked to developments

Publish all records in this dataset.

Field	Description	Requirement level	Data type and cardinality	Related information
Reference (`reference`)	the reference for the section 106 agreement	`MUST`	`string` 1
Name (`name`)	Title or plain-language label for the section 106 agreement so it can be identified	`SHOULD`	`string` 1
Decision notice (`decision-notice`)	the reference for the decision notice tied to the section 106 agreement	`MUST`	`string` 1	Refers to the decision-notice dataset.
Document URL (`document-url`)	the URL to the published section 106 agreement document	`SHOULD`	`url` 1
Documentation URL (`documentation-url`)	the URL of the page where the section 106 agreement can be found	`MUST`	`url` 1

Back to list of datasets

Planning application document

Links a planning application to the documents submitted with it.

Records to include: Include only documents the planning authority has decided may appear on the public register.

Field	Description	Requirement level	Data type and cardinality	Related information
Reference (`reference`)	the reference for the document record	`MUST`	`string` 1
Planning application (`planning-application`)	the reference for the related planning application	`MUST`	`string` 1	Refers to the planning-application dataset.
Document URL (`document-url`)	the URL to the document file	`SHOULD`	`url` 1
Documentation URL (`documentation-url`)	the URL of the page where the document can be found	`MUST`	`url` 1
Name (`name`)	Title or label used to identify the document	`MUST`	`string` 1
Replaces (`replaces`)	Reference to an earlier document record replaced by this document	`MUST`	`string` 1	Refers to the planning-application-document dataset.

Back to list of datasets

Planning permission timeline

Records key events in the processing of a planning application.

Records to include: Include only permission process events selected for the national public view.

Field	Description	Requirement level	Data type and cardinality	Related information
Reference (`reference`)	the reference for the timeline entry	`MUST`	`string` 1
Planning application (`planning-application`)	the reference for the related planning application	`MUST`	`string` 1	Refers to the planning-application dataset.
Permission process event (`permission-process-event`)	the type of event in the permission process	`MUST`	`enum` 1	Allowed values are in the permission-process-event codelist.
Event date (`event-date`)	the date the event occurred	`MUST`	`datetime` 1

Back to list of datasets