Planning applications nearby

gethttps://crystalroof.co.uk/customer-api/planning-applications/closest/v1/{location}

Description

This API method retrieves the closest planning applications that match the specified filters.

The type and status fields provide mapped type and status values respectively, processed using our internal algorithms for consistency and clarity.
The originalTypeMessage and originalStatusMessage fields contain the original type and status values as retrieved directly from the corresponding planning portal.

We are currently enhancing this method, and a new category parameter will soon be introduced to allow for more refined and targeted searches.

Parameters

Name	Description
location path string	Postcode, coordinates in the lat,long format or UPRN in the uprn12345678 format. Examples Postcode with or without space. This argument is case-insensitive. Value
status query array	Which statuses planning applications should have. Default is all. Default (all)
type query array	Which types planning applications should have. Default is all. unknown - "Unknown". The application type is unknown. full - "Full Application". Required for new buildings, major alterations, and land-use changes that don’t fall under permitted development. Example: Building a new house or converting a warehouse into apartments. outline - "Outline Planning Permission". Establishes the general principle of development without full design details. Example: Seeking permission for a housing development before submitting detailed plans. reservedMatters - "Reserved Matters Application". Follows an outline planning application to provide details such as layout, appearance, and access. householder - "Householder Planning Permission". Used for small-scale home improvements that don’t fall under permitted development rights. Example: Adding a large extension, loft conversion, or garden building. priorApproval - "Prior Approval". A streamlined process for some permitted developments where the council must approve specific aspects. Example: Office-to-residential conversions, larger home extensions. priorNotification - "Prior Notification". Used to inform the council about certain works where minimal assessment is needed. Example: Demolition of a building, new agricultural structures. advertisementConsent - "Advertisement Consent". Needed for displaying certain signs, billboards, or illuminated advertisements. listedBuilding - "Listed Building Consent". Required for any changes to a listed building that may affect its character. Example: Replacing windows in a listed Georgian townhouse. ldc - "Lawful Development Certificate". Confirms that an existing or proposed development is legal under planning law. Example: Verifying that a loft conversion falls under permitted development. changeOfUse - "Change of Use". Needed when changing a building’s use class beyond what’s allowed under permitted development. trees - "Works on Trees". Application is subject to a Tree Preservation Order (TPO) and/or Notification of Proposed Works to Trees in Conservation Areas (CA). eia - "Environmental Impact Assessment". Required for large developments that could have significant environmental impacts. Example: A large industrial site, airport expansion, or major housing estate. dischargeOfConditions - "Discharge of Conditions". Confirms that conditions attached to planning permission have been met. Example: Submitting materials samples before starting construction. nonMaterialAmendment - "Non-Material Amendment". Used for minor changes to an approved planning permission that do not significantly alter the proposal. Example: Slightly adjusting a building’s window placement. historic - "Historic Application". Typically used to store applications submitted before 1990 or when application rules were significantly different. conservationAreaConsent - "Conservation Area Consent". Required for demolishing buildings in a conservation area. Example: Removing an old structure in a historic town centre. hedgerowRemovalNotice - "Hedgerow Removal Notice". used by anyone proposing to remove a hedgerow, or part of a hedgerow, covered by the Hedgerows Regulations Default (all)
updated_within_days query integer	Show applications that have been updated within this number of days. The default is 3650 (10 years). Maximum is 36500 (100 years), minimum is 7 (1 week).
documents query boolean	Include planning applications documents in the response.
limit query enum	Number of elements to be returned by the method. The returned number of elements may be less than the requested amount if fewer elements are found based on your criteria (in very rare cases). The maximum value is 20. To retrieve only the metadata, use the value 0. Value
api_key query enum	Your API key. `DEMO` key allows you to test the method in the `W6 0` postcode sector, or in the `[[51.492, -0.25], [51.502, -0.225]]` rectangle. Value

Request URL:

https://crystalroof.co.uk/customer-api/planning-applications/closest/v1/W60WW?api_key=DEMO

Possible responses with examples

Code

Description

200

Success

{
  "data": [
    {
      "id": "412d4ea97ea12574b24706899f257ebc",
      "reference": "2018/02683/FUL",
      "url": "https://public-access.lbhf.gov.uk/online-applications/applicationDetails.do?activeTab=summary&keyVal=PD7BQRBIHX300",
      "address": "56 Ashlar Court 21 Ravenscourt Gardens London W6 0TU",
      "uprn": 34153630,
      "wardCode": "E05013746",
      "wardName": "Ravenscourt",
      "localAuthorityDistrictCode": "E09000013",
      "localAuthorityDistrictName": "Hammersmith and Fulham",
      "description": "Installation of an external chiller unit on the existing terrace located at the eastern side of the flat adjacent to a parapet wall; associated internal and external alterations.",
      "type": "Full Application",
      "originalTypeMessage": "Full Detailed Planning Application",
      "validated": "2018-09-12",
      "received": "2018-08-09",
      "decided": "2018-12-21",
      "decision": "Application Approved",
      "status": "Approved",
      "originalStatusMessage": "Application Approved",
      "agent": {
        "name": null,
        "company": null,
        "address": null
      },
      "appeal": {
        "status": "Unknown",
        "decision": "Not Available"
      },
      "officerName": "Not Available",
      "latitude": 51.495643,
      "longitude": -0.242613,
      "distance": 55.6
    },
    {
      "id": "45e5d45678d5a26b26af4530d921e9a2",
      "reference": "2013/03108/DET",
      "url": "https://public-access.lbhf.gov.uk/online-applications/applicationDetails.do?activeTab=summary&keyVal=MQG87EBIGX000",
      "address": "Ashlar Court 21 Ravenscourt Gardens London",
      "uprn": 34008391,
      "wardCode": "E05013746",
      "wardName": "Ravenscourt",
      "localAuthorityDistrictCode": "E09000013",
      "localAuthorityDistrictName": "Hammersmith and Fulham",
      "description": "Submission of details of internal elevations pursuant to condition 16 of planning permission ref. 2010/02917/FUL granted on 28th March 2012; condition 14 of planning permission 2013/00010/VAR granted on 14th March 2013; condition 15 of planning permission 2013/00011/VAR granted on 14th March 2013.",
      "type": "Outline Planning Permission",
      "originalTypeMessage": "Details to Meet Conditions Full/Outline",
      "validated": "2013-07-26",
      "received": "2013-07-24",
      "decided": "2015-06-29",
      "decision": "Application Approved",
      "status": "Approved",
      "originalStatusMessage": "Application Approved",
      "agent": {
        "name": null,
        "company": null,
        "address": null
      },
      "appeal": {
        "status": "Unknown",
        "decision": "Not Available"
      },
      "officerName": "Not Available",
      "latitude": 51.495643,
      "longitude": -0.242613,
      "distance": 55.6
    },
    {
      "id": "7a68aa0ee1b583be56432570e488e069",
      "reference": "2013/05478/DET",
      "url": "https://public-access.lbhf.gov.uk/online-applications/applicationDetails.do?activeTab=summary&keyVal=MY21U9BIGX000",
      "address": "Ashlar Court 21 Ravenscourt Gardens London",
      "uprn": 34008391,
      "wardCode": "E05013746",
      "wardName": "Ravenscourt",
      "localAuthorityDistrictCode": "E09000013",
      "localAuthorityDistrictName": "Hammersmith and Fulham",
      "description": "Submission of details of Integrated Reception System pursuant to condition 21 of planning permission 2010/02917/FUL dated 28th March 2012; condition 18 of planning permission 2013/00010/VAR dated 14th March 2013; condition 19 of planning permission 2013/00011/VAR dated 14th March 2013 and condition 12 of planning permission 2013/00012/VAR dated 2nd August 2013.",
      "type": "Outline Planning Permission",
      "originalTypeMessage": "Details to Meet Conditions Full/Outline",
      "validated": "2014-01-20",
      "received": "2013-12-19",
      "decided": "2015-06-25",
      "decision": "Application Approved",
      "status": "Approved",
      "originalStatusMessage": "Application Approved",
      "agent": {
        "name": "Mr Aidan Robson",
        "company": "Linden Homes South East",
        "address": null
      },
      "appeal": {
        "status": "Unknown",
        "decision": "Not Available"
      },
      "officerName": "Not Available",
      "latitude": 51.495643,
      "longitude": -0.242613,
      "distance": 55.6
    },
    {
      "id": "86953ab71f16e3b23b28da7c72eedd31",
      "reference": "2013/05063/DET",
      "url": "https://public-access.lbhf.gov.uk/online-applications/applicationDetails.do?activeTab=summary&keyVal=MWTS5BBIGX000",
      "address": "Ashlar Court 21 Ravenscourt Gardens London",
      "uprn": 34008391,
      "wardCode": "E05013746",
      "wardName": "Ravenscourt",
      "localAuthorityDistrictCode": "E09000013",
      "localAuthorityDistrictName": "Hammersmith and Fulham",
      "description": "Submission of details of external lighting pursuant to condition 39 of planning permission 2010/02917/FUL; condition 32 of planning permission ref. 2013/00010/VAR, condition 33 of planning permission 2013/00011/VAR and condition 23 of planning permission 2013/00012/VAR granted 28th March 2012.",
      "type": "Outline Planning Permission",
      "originalTypeMessage": "Details to Meet Conditions Full/Outline",
      "validated": "2013-11-26",
      "received": "2013-11-25",
      "decided": "2015-06-23",
      "decision": "Application Approved",
      "status": "Approved",
      "originalStatusMessage": "Application Approved",
      "agent": {
        "name": "Aidan Robson",
        "company": "Linden Homes South East",
        "address": null
      },
      "appeal": {
        "status": "Unknown",
        "decision": "Not Available"
      },
      "officerName": "Not Available",
      "latitude": 51.495643,
      "longitude": -0.242613,
      "distance": 55.6
    },
    {
      "id": "bde3301bc3177e1e8bf761608c1729c2",
      "reference": "2012/03500/DET",
      "url": "https://public-access.lbhf.gov.uk/online-applications/applicationDetails.do?activeTab=summary&keyVal=MCIG2FBIGX000",
      "address": "Ashlar Court Ravenscourt Gardens London W6 0TU",
      "uprn": 34008391,
      "wardCode": "E05013746",
      "wardName": "Ravenscourt",
      "localAuthorityDistrictCode": "E09000013",
      "localAuthorityDistrictName": "Hammersmith and Fulham",
      "description": "Submission of details of detailed elevation drawings pursuant to condition 4 of planning permission 2013/00010/VAR dated 14th March 2013 and condition 5 of planning permission 2013/00011/VAR dated 14th March 2013.",
      "type": "Outline Planning Permission",
      "originalTypeMessage": "Details to Meet Conditions Full/Outline",
      "validated": "2012-11-01",
      "received": "2012-10-31",
      "decided": "2015-06-29",
      "decision": "Application Approved",
      "status": "Approved",
      "originalStatusMessage": "Application Approved",
      "agent": {
        "name": "Aidan Robson",
        "company": "Linden Homes South East",
        "address": null
      },
      "appeal": {
        "status": "Unknown",
        "decision": "Not Available"
      },
      "officerName": "Not Available",
      "latitude": 51.495643,
      "longitude": -0.242613,
      "distance": 55.6
    }
  ]
}

401

Unauthorized

{
  "error": "No such API key or it is not valid anymore."
}

402

Payment Required

{
  "error": "You have exhausted the available calls provided by your package."
}

403

Forbidden

{
  "error": "API key is invalid for the given action."
}

429

Too Many Requests

{
  "error": "Too many requests have been sent in one second."
}

500

Internal Server Error

{
  "error": "We have already started working on a resolution!"
}