Developer Platform

Planning Alerts API

Self-serve REST API for Planning Data-sourced planning applications and council reference data. Explore documented endpoints, authenticated requests, and clear monthly usage allowances.

Authentication

All API requests require a Bearer token in the Authorization header. Trial keys are prefixed with pa_trial_ and paid keys are prefixed with pa_live_.

curl https://planningalerts.app/v1/applications?postcode=SW1A1AA \
-H "Authorization: Bearer pa_live_xxxxxxxxxxxx"

Base URL: https://planningalerts.app

Start API trial

API Pricing

API Trial

£0for 14 days

1,000 API calls
Applications and councils
No card required
Self-serve API key

Start free trial

API Starter

£29/mo

10,000 API calls/month
REST API access
Planning Data coverage
Usage dashboard

Choose plan

API Reference

GET/v1/applications

Search Planning Data-sourced planning applications by postcode, status, or free text.

Parameters

postcodestringUK postcode (e.g. SW1A1AA)

qstringReference, address, or description keywords

statusstringPermitted | Refused | Undecided | Withdrawn

councilstringCouncil/LPA code

limitintegerResults per request (max 100, default 25)

Example

GET /v1/applications?postcode=SW1A1AA&status=Undecided
Authorization: Bearer pa_live_xxxxxxxxxxxx

{
  "total": 12,
  "items": [
    {
      "id": 1234567,
      "reference": "25/00456/FUL",
      "lpa_code": "WCC",
      "address": "14 Oak Street, London SW1A 1AA",
      "description": "Erection of single-storey rear extension",
      "app_status": "Undecided",
      "app_type": "Full",
      "received_date": "2026-07-15",
              "source": "planningdata",
              "source_url": "https://www.planning.data.gov.uk/..."
    }
  ]
}

GET/v1/applications/:id

Retrieve a single planning application by its internal ID.

Example

GET /v1/applications/1234567
Authorization: Bearer pa_live_xxxxxxxxxxxx

GET/v1/councils

List all 312 councils with their portal status and last scrape timestamp.

Example

GET /v1/councils
Authorization: Bearer pa_live_xxxxxxxxxxxx

Webhook Events

Event delivery is the next API capability planned for API Growth and API Pro. Start with the current REST API trial and use the developer dashboard to monitor keys and usage.

new_application

A new planning application has been submitted

status_change

An application status has changed (e.g. Undecided → Permitted)

Planning Alerts B2B API

What data is available?

The Planning Alerts API provides Planning Data-sourced planning applications and council reference data. Each application record includes the reference number, address, description, application type, status, received date, consultation deadline, source label, and published source link.

Who uses the API?

The API is used by property developers, estate agents, conveyancers, planning consultants, and PropTech companies who need programmatic access to UK planning application data. Common use cases include due diligence, site monitoring, portfolio management, and automated planning alerts for clients.

Data licensing

Contains Planning Data public sector information licensed under the Open Government Licence v3.0. Any product or service displaying data obtained via the API must retain this attribution and link to the Open Government Licence v3.0.

Getting started

Create an account to start a 14-day API trial with 1,000 requests and no card required. Your API key is available in the developer dashboard. All API requests must include your key in the Authorization: Bearer header. The base URL is https://planningalerts.app/v1.