Documentation menu
Get started
Planning Signal API
The Planning Signal API is a read-only REST API for UK planning applications and the conditions on councils' decision notices. Search by council, postcode and radius, keyword, status or date, and pull the results into your own software. It is the same data as the Planning Signal website, which comes from public council planning registers.
- Base URL:
https://planningsignal.co.uk/api/v1 - JSON over HTTPS. Every endpoint is a
GET. - Authentication:
Authorization: Bearer ps_live_...(details) - Priced by records: each application or condition returned counts once a month, however often you fetch it (details)
- 60 requests a minute per key (details)
- Machine-readable description: OpenAPI 3.1
Your first call in two minutes
Get a free demo key (100 records, no card), then:
curl "https://planningsignal.co.uk/api/v1/applications?authority=Camden&since=2026-09-01&limit=5" \
-H "Authorization: Bearer ps_live_your_key_here"The quick start walks through it in curl, JavaScript and Python.
Endpoints
| Endpoint | What it does | Access |
|---|---|---|
GET /applications | Search and list planning applications by council, postcode and radius, keyword, status and dates. | All plans, including the free demo |
GET /applications/:id | Fetch one application by its id. | All plans, including the free demo |
GET /applications/:id/conditions | The conditions on one application's decision notice. | API Pro, Leads and National |
GET /conditions | Search decision-notice conditions across every council, by discipline and phrase. | API Pro, Leads and National |
GET /authorities | Every council we hold applications for, with a count. Free. | All plans, including the free demo |
GET /usage | Your plan, allowance, records used and reset date. Free. | All plans, including the free demo |
GET /portfolio/sites | Your Portfolio Monitor sites. Portfolio Monitor customers only. | Portfolio Monitor customers |
GET /portfolio/matches | Applications on or near your Portfolio Monitor sites. Portfolio Monitor customers only. | Portfolio Monitor customers |
Plans at a glance
| Plan | Price | Records | Contacts and conditions |
|---|---|---|---|
| Free demo | Free | 100, once (never resets) | No |
| API Starter | £49 a month + VAT | 2,500 a month | No |
| API Pro | £149 a month + VAT | 10,000 a month | Yes |
| National / bulk | From £399 a month + VAT | Agreed with you | Yes |
| Leads website plan | Included | 1,000 a month | Yes |
Allowances add up if you hold more than one plan. Buy or change a plan on the API page. API plans are separate from the website plans.
Versioning and changes
The version is in the path (/api/v1). New fields and parameters can be added to v1, so ignore fields you do not recognise. Every change is listed in the changelog.
Good to know
- Council registers can be incomplete or late, and the council's own register is the official record. Each application's
urllinks to it. - Applicant names and home addresses are never returned, on any plan.
- Use is covered by the API & Data Licence: use the data in your organisation and show individual records to your users, credited "Planning data from Planning Signal". No resale or bulk redistribution.
- Want updates pushed to you instead? Website plans from Research can send new applications to a webhook, Slack or Teams.
Questions? Contact us, or see the help centre.