Planning applications nearby

UK
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.

Pricing

1 credit per 10 returned applications

Example: 11 applications = 2 credits

If 0 applications are returned, the call still counts as 1 credit

Parameters

NameDescription
location
path
string
Postcode, coordinates in the lat,long format or UPRN in the uprn12345678 format.
status
query
array
Which statuses planning applications should have. Default is 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
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 100. To retrieve only the metadata, use the value 0.

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.

Request URL:
https://crystalroof.co.uk/customer-api/planning-applications/closest/v1/{location}?api_key=DEMO
Possible responses with examples
Code
Description
200
Success
401
Unauthorized
402
Payment Required
403
Forbidden
404
Not Found
429
Too Many Requests
500
Internal Server Error