National public view

The national public view defines the planning application data that planning authorities must publish openly.

This is the definitive publication contract. Publish every listed field for each included record, except that development-scale applies only to full and outline planning applications.

View the raw schema on GitHub

Find out how the national public view works

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	Data type and cardinality	Related information
Reference (`reference`)	the reference used for the planning application, for example 2025/1674	`string` 1
Description (`description`)	the description of the proposed development	`string` 1
Application types (`application-types`)	one or more application types that the application covers	`enum` n	Allowed values are in the application-type codelist.
Site (`site`)	the reference to the related site	`string` 1	Refers to the site dataset.
Received date (`received-date`)	the date the planning authority received the application	`datetime` 1
Planning authority (`planning-authority`)	Identifier of the planning authority that received this planning application	`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.	`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	`boolean` 1
Withdrawn date (`withdrawn-date`)	the date the planning application was withdrawn	`datetime` 1
Linked applications (`linked-applications`)	references to earlier applications this application directly links to	`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	`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	`url` 1

Back to list of datasets

Site

Records of development sites linked to planning applications

Publish all records in this dataset.

Field	Description	Data type and cardinality	Related information
Reference (`reference`)	the reference for the site	`string` 1
Name (`name`)	a plain-language name for the site so it can be referenced in discussions and reports	`string` 1
Address Text (`address-text`)	the address for the site, where one is available	`string` 1
Postcode (`postcode`)	postcode for the site, where one is available	`string` 1
Description (`description`)	a plain-language description of the site, where this helps identify the land or buildings	`string` 1
Geometry (`geometry`)	the boundary for the site	`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	Data type and cardinality	Related information
Reference (`reference`)	the reference for the decision notice	`string` 1
Planning application (`planning-application`)	the reference for the planning application the decision notice is for	`string` 1	Refers to the planning-application dataset.
Decision (`decision`)	the decision outcome for the planning application	`string` 1
Decision date (`decision-date`)	the date the decision notice was issued	`datetime` 1
Organisation (`organisation`)	the organisation issuing the decision notice	`enum` 1	Allowed values are in the organisations codelist.
Decision maker (`decision-maker`)	who made the decision	`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	`string` 1
Document URL (`document-url`)	the URL to the published decision notice	`url` 1
Documentation URL (`documentation-url`)	the URL of the page where the decision notice can be found	`url` 1

Back to list of datasets

Planning condition

Records of individual planning conditions

Publish all records in this dataset.

Field	Description	Data type and cardinality	Related information
Reference (`reference`)	a reference for the planning condition	`string` 1
Name (`name`)	a plain-language label for the condition	`string` 1
Description (`description`)	the text of the condition that must be met	`string` 1
Reason (`reason`)	an explanation of why the condition was imposed	`string` 1
Organisation (`organisation`)	the organisation responsible for this condition	`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	Data type and cardinality	Related information
Reference (`reference`)	the reference for the decision condition	`string` 1
Decision notice (`decision-notice`)	the reference for the decision notice this condition is attached to	`string` 1	Refers to the decision-notice dataset.
Planning condition (`planning-condition`)	the reference for the linked planning condition record	`string` 1	Refers to the planning-condition dataset.
Organisation (`organisation`)	the organisation responsible for this condition within the decision	`enum` 1	Allowed values are in the organisations codelist.
Requested by (`requested-by`)	identifier of the body requesting the condition	`enum` 1	Allowed values are in the organisations codelist.
Discharged by (`discharged-by`)	identifier of the decision notice discharging the condition	`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	Data type and cardinality	Related information
Reference (`reference`)	the reference for the section 106 agreement	`string` 1
Decision notice (`decision-notice`)	the reference for the decision notice tied to the section 106 agreement	`string` 1	Refers to the decision-notice dataset.
Document URL (`document-url`)	the URL to the published section 106 agreement document	`url` 1
Documentation URL (`documentation-url`)	the URL of the page where the section 106 agreement can be found	`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	Data type and cardinality	Related information
Reference (`reference`)	the reference for the document record	`string` 1
Planning application (`planning-application`)	the reference for the related planning application	`string` 1	Refers to the planning-application dataset.
Document URL (`document-url`)	the URL to the document file	`url` 1
Documentation URL (`documentation-url`)	the URL of the page where the document can be found	`url` 1
Name (`name`)	Title or label used to identify the document	`string` 1
Replaces (`replaces`)	Reference to an earlier document record replaced by this document	`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	Data type and cardinality	Related information
Reference (`reference`)	the reference for the timeline entry	`string` 1
Planning application (`planning-application`)	the reference for the related planning application	`string` 1	Refers to the planning-application dataset.
Permission process event (`permission-process-event`)	the type of event in the permission process	`enum` 1	Allowed values are in the permission-process-event codelist.
Event date (`event-date`)	the date the event occurred	`datetime` 1

Back to list of datasets