Minaki Planning — UK Planning Data API
Free, structured API for UK local-authority planning applications. Aggregated from council portals via a pluggable per-vendor adapter model — one HTTP call, one JSON response, no per-council scraping to write yourself.
alpha Idox Public Access adapter live. Atrium, Tascomi, NIPortal, Arcus, Agile and Ocella adapters pending. See the full council list.
Last updated 2026-07-27 21:50 UTC
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /health | Row counts & ping |
| GET | /councils | List councils and record counts |
| GET | /applications | Query planning applications |
| GET | /application/{council}/{reference} | Full detail for one application |
Query parameters for /applications:
council,
postcode,
status,
since (ISO date),
q (free text),
limit,
offset.
Try it
# All applications, first 3
curl -s 'https://planning.minaki.io/applications?limit=3' | jq
# One council (see /councils for the full list of slugs)
curl -s 'https://planning.minaki.io/applications?council=bradford&limit=5' | jq
# By outward postcode
curl -s 'https://planning.minaki.io/applications?postcode=BD7&limit=5' | jq
# Free-text search
curl -s 'https://planning.minaki.io/applications?q=extension&limit=5' | jq
# One specific application (council/reference)
curl -s 'https://planning.minaki.io/application/rutland/2026/0924/CAT' | jq
How it works
UK councils run around ten different planning-portal products, but Idox Public Access alone covers roughly 56% of local planning authorities. Rather than write 420 scrapers, this project uses one adapter per vendor plus a JSON config listing which council runs which platform. A new council is a new row; a new vendor is a new adapter file.
Fetching is deliberately polite: two-second delay between requests per host, descriptive User-Agent identifying the project with a contact address, one session per council, sequential not parallel. Councils sit on public registers of planning decisions; aggregating and re-serving them is well-established open-data practice.