Planning application by id

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

Description

This method returns detailed information about a specific planning application, using its unique application id.

It can be used in conjunction with the Planning applications in a map tile method, which returns basic information for all applications within a given map tile. Once an application is selected (e.g., by clicking on a map pin), this method can be used to fetch full details.

The type and status fields return normalised values, processed using our internal algorithms to ensure consistency and clarity across all datasets.

Pricing

1 credit per 1 request.

Parameters

Name	Description
id path string	The `id` is a unique identifier for a planning application in our storage system. It is not associated with identifiers from external systems or third-party databases.
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/v1/412d4ea97ea12574b24706899f257ebc?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,
    "documents": [
      {
        "date": "2018-12-21",
        "link": "https://public-access.lbhf.gov.uk/online-applications/files/22C7D91538A0F3FB695D22137D407CED/pdf/2018_02683_FUL-DELEGATED_REPORT_TEMPLATE_-_LIVE-2155063.pdf",
        "name": null,
        "status": null,
        "category": "Report",
        "description": "DELEGATED REPORT TEMPLATE - LIVE"
      },
      {
        "date": "2018-12-21",
        "link": "https://public-access.lbhf.gov.uk/online-applications/files/278B3EDE63D57CB3FC1E0B7C3C7DAA28/pdf/2018_02683_FUL-FULL_PLANNING_PERMISSION-2155129.pdf",
        "name": null,
        "status": null,
        "category": "Decision",
        "description": "FULL PLANNING PERMISSION"
      },
      {
        "date": "2018-11-26",
        "link": "https://public-access.lbhf.gov.uk/online-applications/files/27B20A7561A446A0E52F7A7C6AE762C8/pdf/2018_02683_FUL-PROPOSED_PLANS-2154376.pdf",
        "name": null,
        "status": null,
        "category": "Revised Drawing",
        "description": "PROPOSED PLANS"
      }
    ]
  }
}

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."
}

404

Not Found

{
  "error": "The planning application with ID \"foo\" could not be found."
}

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!"
}