Skip to content
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

EndpointWhat it doesAccess
GET /applicationsSearch and list planning applications by council, postcode and radius, keyword, status and dates.All plans, including the free demo
GET /applications/:idFetch one application by its id.All plans, including the free demo
GET /applications/:id/conditionsThe conditions on one application's decision notice.API Pro, Leads and National
GET /conditionsSearch decision-notice conditions across every council, by discipline and phrase.API Pro, Leads and National
GET /authoritiesEvery council we hold applications for, with a count. Free.All plans, including the free demo
GET /usageYour plan, allowance, records used and reset date. Free.All plans, including the free demo
GET /portfolio/sitesYour Portfolio Monitor sites. Portfolio Monitor customers only.Portfolio Monitor customers
GET /portfolio/matchesApplications on or near your Portfolio Monitor sites. Portfolio Monitor customers only.Portfolio Monitor customers

Plans at a glance

PlanPriceRecordsContacts and conditions
Free demoFree100, once (never resets)No
API Starter£49 a month + VAT2,500 a monthNo
API Pro£149 a month + VAT10,000 a monthYes
National / bulkFrom £399 a month + VATAgreed with youYes
Leads website planIncluded1,000 a monthYes

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 url links 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.