Documentation

Everything you need to integrate UK planning data

Getting started? Sign up for a free API key to get 500 calls per month. No credit card required.

Quick Start

  • Get your API key

    Sign up at planningapi.uk/signup to receive your API key instantly.

  • Make your first request

    Use your API key to query any UK address for planning data.

    # Look up planning applications for an address
curl "https://api.planningapi.uk/v1/lookup?address=10+Downing+Street" \
  -H "Authorization: Bearer YOUR_API_KEY"

  • Parse the response

    Receive normalised JSON data with planning applications, status, and site constraints.

API Reference

🔍

Planning Lookup API

Get planning history for any UK address. Applications, decisions, conditions.
📡

Monitoring API

Subscribe to addresses and receive webhook notifications on changes.
📄

Reports API

Generate audit-ready PDF reports with full planning history.
📦

Bulk Lookup API

Verify planning status for multiple addresses at once.
📍

Geocoding API

Convert addresses to coordinates. Radius search for applications.
🏛️

Council Data API

Metadata for all UK planning authorities.

Authentication

All API requests require authentication via Bearer token. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Keep your API key secure. Do not expose it in client-side code or public repositories.

Rate Limits

API rate limits depend on your plan:

  • Free: 500 requests per month, 10 requests per minute
  • Starter: 5,000 requests per month, 60 requests per minute
  • Professional: 25,000 requests per month, 120 requests per minute
  • Enterprise: Custom limits

Rate limit headers are included in every response to help you track usage.

Error Handling

The API uses standard HTTP status codes. Common responses:

  • 200 OK: Request successful
  • 400 Bad Request: Invalid parameters
  • 401 Unauthorised: Missing or invalid API key
  • 404 Not Found: Address not found
  • 429 Too Many Requests: Rate limit exceeded
  • 500 Internal Server Error: Server error (contact support)

Need Help?

If you have questions about integrating our API: