v1

latestOpenAPI 3.0.32026-08-0638140175.8 KB

Planning Applications

Bulk planning application details

Get detailed information about a set of planning applications, given a set of unique planning application IDs e.g. a local authority GSS code and reference separated by a plus sign (+).

Schema is subject to change.

post/planning-applications

Request body

planning_applicationsPlanningApplicationId[] required

List of IDs comprised of a GSS code and ref separated by a plus sign (+) e.g. E07000112+Y18/1381/FH.

Example request

{
  "planning_applications": [
    "E07000112+Y18/1381/FH"
  ]
}

Response

Planning application details

idstring

Internal LandTech ID of the planning application.

gss_codestring

GSS code of the planning authority.

refstring

Reference number used by the planning authority.

num_dwellingsnumber

Number of residential units we have identified the application is for.

addressstring

Address of the property the application is for.

titlestring

Description of the planning application.

urlstring nullable

URL to the planning authority's page. Where possible this links directly to the planning application.

types_derivedstring[]

Identified "types" of the application

statusstring nullable

Current status of the application, e.g. Decided.

decisionstring nullable

The decision on the application, e.g. Permit.

date_receivedstring date-time

Date the application was received by the authority.

decision_datestring date-time nullable

Date the decision was made on the application.

agent_addressstring nullable

Address of the agent who submitted the application.

agent_namestring nullable

Name of the agent who submitted the application.

applicant_namestring nullable

Name of the person who submitted the application.

status_derived'Approved' | 'Rejected' | 'Pending' | 'Withdrawn' | 'Unknown'

Normalized status of the application.

updatedstring date-time

When the application was last processed by LandTech.

classification'RESIDENTIAL' | 'COMMERCIAL' | 'MIXED_USE' | 'OTHER'

Classification of the application.

sizenumber

Same as num_dwellings.

found_num_dwellingsboolean

Flag stating that we have identified a number of residential units (dwellings).

tagsstring[] 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_numberstring nullable

The Planning Inspectorate (PINS) Reference Number

appeal_type_of_appealstring nullable

Appeal type

appeal_type_reasonstring nullable

Appeal reason (this field is only populated for certain types of appeals)

appeal_application_refstring nullable

Local Planning Authority application reference number relating to the appeal

appeal_planning_authority_namestring nullable

Local Planning Authority Name, if known

appeal_site_addressstring nullable

Address of the site

appeal_decisionstring nullable

Appeal decision

appeal_decision_datestring 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_datestring date-time nullable

Date received in Planning Inspectorate (PINS)

appeal_development_typestring nullable

Development type being appealed

appeal_inspector_namestring nullable

Planning Inspector's name, if known

appeal_appellantstring nullable

Appellant's name

appeal_updated_atstring date-time nullable

Date the appeal was processed by LandTech

is_full_applicationboolean

Flag indicating "types_derived" includes "Full Application"

is_outlineboolean

Flag indicating "types_derived" includes "Outline"

is_discharge_of_conditionsboolean

Flag indicating "types_derived" includes "Discharge of Conditions"

is_gpdrboolean

Flag indicating "types_derived" includes "GPDR" (General Permitted Development - Class R)

is_reserved_mattersboolean

Flag indicating "types_derived" includes "Reserved Matters"

is_tpoboolean

Flag indicating "types_derived" includes "TPO" (Tree Preservation Order)

is_listed_buildingboolean

Flag indicating "types_derived" includes "Listed Building"

is_eiaboolean

Flag indicating "types_derived" includes "EIA" (Environmental Impact Assessment)

is_change_of_useboolean

Flag indicating "types_derived" includes "Change of Use"

is_uncategorisedboolean

Flag indicating we have been unable to "derive" a "type" (i.e: "types_derived" is empty)

is_minorboolean

Flag indicating we have identified the application is a "minor" application, i.e. Phone or Post Boxes, Kiosks, ATMs, Advertisements, Signage or Lighting.

Example response

[
  {
    "id": "E09000033+16/02592/LBC",
    "gss_code": "E09000033",
    "ref": "16/02592/LBC",
    "num_dwellings": 1,
    "address": "Victoria Gate Lodge Hyde Park Bayswater Road London SW7 1NR",
    "title": "Internal and external alterations of the lodge including general internal and external repairs and refurbishment.",
    "location": {
      "type": "Point",
      "coordinates": [
        -0.12755,
        51.5073
      ]
    },
    "boundary": {
      "type": "MultiPolygon",
      "coordinates": [
        [
          [
            [
              -0.12755,
              51.5073
            ]
          ]
        ]
      ]
    },
    "url": "https://apps.stratford.gov.uk/eplanning/AppDetail.aspx?appkey=OA70D2PM00E00",
    "status": "Permission with conditions",
    "decision": "Permission with conditions",
    "date_received": "2016-07-07T00:00:00.000Z",
    "decision_date": "2016-09-21T00:00:00.000Z",
    "agent_address": "The Studio, 42 Placeholder Avenue, Fictiontown-upon-Test, EX4 8MP",
    "agent_name": "Joe Doe",
    "applicant_name": "John Smith",
    "status_derived": "Approved",
    "updated": "2023-05-26T03:09:36.191Z",
    "classification": "RESIDENTIAL",
    "size": 1,
    "tags": [
      "Hotel",
      "Demolition",
      "Retail (A1)",
      "Restaurants and cafés (A3)",
      "Office (B1)"
    ],
    "appeal_case_number": "1234567",
    "appeal_type_of_appeal": "Planning Appeal",
    "appeal_type_reason": "1. Refused planning permission",
    "appeal_application_ref": "P1284/13/OUT",
    "appeal_planning_authority_name": "London Borough of Barnet",
    "appeal_site_address": "The Annex, 7 Example Crescent, Testford-upon-Mere, XY45 6ZT",
    "appeal_decision": "Dismissed",
    "appeal_decision_date": "2017-08-02T00:00:00.000Z",
    "appeal_received_date": "2014-05-15T00:00:00.000Z",
    "appeal_development_type": "Householder developments",
    "appeal_inspector_name": "James Smith",
    "appeal_appellant": "James Thompson",
    "appeal_updated_at": "2023-05-26T03:09:36.191Z",
    "is_listed_building": true,
    "related_applications": [
      {
        "gss_code": "E09000033",
        "refs": [
          "16/02592/LBC"
        ]
      }
    ]
  }
]