---
title: "Details of a planning application"
method: GET
path: "/planning-applications/{gss_code}/{ref}"
tags: ["Planning Applications"]
---

# Details of a planning application

`GET /planning-applications/{gss_code}/{ref}`

Get detailed information about a planning application, given its local authority GSS code and application reference.

## Path parameters

- `gss_code` string, required — Geocode as maintained by the United Kingdom's Office for National Statistics (ONS) to represent a wide range of geographical areas of the UK.
- `ref` string, required

## Response `200`

Planning application details

- PlanningApplication
  - `id` string — Internal LandTech ID of the planning application.
  - `gss_code` string — GSS code of the planning authority.
  - `ref` string — Reference number used by the planning authority.
  - `num_dwellings` number — Number of residential units we have identified the application is for.
  - `address` string — Address of the property the application is for.
  - `title` string — Description of the planning application.
  - `location` Point — GeoJSON Point
    - `type` 'Point', required — the geometry type
    - `coordinates` number[], required
  - `boundary` MultiPolygon — GeoJSON MultiPolygon
    - `type` 'MultiPolygon', required — the geometry type
    - `coordinates` PolygonCoordinates[], required
      - LinearRingCoordinates[]
        - PointCoordinates[]
          - number[]
  - `url` string, nullable — URL to the planning authority's page. Where possible this links directly to the planning application.
  - `types_derived` string[] — Identified "types" of the application
  - `status` string, nullable — Current status of the application, e.g. Decided.
  - `decision` string, nullable — The decision on the application, e.g. Permit.
  - `date_received` string, date-time — Date the application was received by the authority.
  - `decision_date` string, date-time, nullable — Date the decision was made on the application.
  - `agent_address` string, nullable — Address of the agent who submitted the application.
  - `agent_name` string, nullable — Name of the agent who submitted the application.
  - `applicant_name` string, nullable — Name of the person who submitted the application.
  - `status_derived` 'Approved' | 'Rejected' | 'Pending' | 'Withdrawn' | 'Unknown' — Normalized status of the application.
  - `updated` string, date-time — When the application was last processed by LandTech.
  - `classification` 'RESIDENTIAL' | 'COMMERCIAL' | 'MIXED_USE' | 'OTHER' — Classification of the application.
  - `size` number — Same as num_dwellings.
  - `found_num_dwellings` boolean — Flag stating that we have identified a number of residential units (dwellings).
  - `tags` string[], nullable — A list of "tags" which describe features of the application. Often identifies a specific use class, or can be more generic such as "Demolition", "Hotel" or "Care Home".
  - `appeal_case_number` string, nullable — The Planning Inspectorate (PINS) Reference Number
  - `appeal_type_of_appeal` string, nullable — Appeal type
  - `appeal_type_reason` string, nullable — Appeal reason (this field is only populated for certain types of appeals)
  - `appeal_application_ref` string, nullable — Local Planning Authority application reference number relating to the appeal
  - `appeal_planning_authority_name` string, nullable — Local Planning Authority Name, if known
  - `appeal_site_address` string, nullable — Address of the site
  - `appeal_decision` string, nullable — Appeal decision
  - `appeal_decision_date` string, nullable — If the Jurisdiction is Transferred then it is the date of the decision made by the Planning Inspectorate (PINS). If the Jurisdiction is Secretary of State then it is the date that the report was sent to the Secretary of State
  - `appeal_received_date` string, date-time, nullable — Date received in Planning Inspectorate (PINS)
  - `appeal_development_type` string, nullable — Development type being appealed
  - `appeal_inspector_name` string, nullable — Planning Inspector's name, if known
  - `appeal_appellant` string, nullable — Appellant's name
  - `appeal_updated_at` string, date-time, nullable — Date the appeal was processed by LandTech
  - `is_full_application` boolean — Flag indicating "types_derived" includes "Full Application"
  - `is_outline` boolean — Flag indicating "types_derived" includes "Outline"
  - `is_discharge_of_conditions` boolean — Flag indicating "types_derived" includes "Discharge of Conditions"
  - `is_gpdr` boolean — Flag indicating "types_derived" includes "GPDR" (General Permitted Development - Class R)
  - `is_reserved_matters` boolean — Flag indicating "types_derived" includes "Reserved Matters"
  - `is_tpo` boolean — Flag indicating "types_derived" includes "TPO" (Tree Preservation Order)
  - `is_listed_building` boolean — Flag indicating "types_derived" includes "Listed Building"
  - `is_eia` boolean — Flag indicating "types_derived" includes "EIA" (Environmental Impact Assessment)
  - `is_change_of_use` boolean — Flag indicating "types_derived" includes "Change of Use"
  - `is_uncategorised` boolean — Flag indicating we have been unable to "derive" a "type" (i.e: "types_derived" is empty)
  - `is_minor` boolean — Flag indicating we have identified the application is a "minor" application, i.e. Phone or Post Boxes, Kiosks, ATMs, Advertisements, Signage or Lighting.
  - `related_applications` object[] — Related planning applications
    - `gss_code` string, required — The GSS code of a planning authority, e.g. `E09000033`.
    - `refs` string[], required

## Other responses

- `403` — Forbidden
- `404` — Application not found

---

[API](https://skmtc.net/land/apis/landtech-api.md) · [All operations](https://skmtc.net/land/apis/landtech-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/land/landtech-api/versions/4608786ac394/schema)