---
title: "Get local planning applications"
method: GET
path: "/planning-applications"
---

# Get local planning applications

`GET /planning-applications`

## Request

- Base URL: `https://api.propertydata.co.uk`
- URL: `https://api.propertydata.co.uk/planning-applications`
- Auth: HTTP bearer

Costs 1 credit per 10 results.

## Query parameters

- `postcode` string
- `location` string
- `category` string
- `application_type` string
- `max_age` integer
- `decision_rating` string
- `max_radius` number
- `results` integer

## Response `200`

Successful response

- object
  - `status` string
  - `postcode` string
  - `postcode_type` string
  - `url` string
  - `result_count` integer
  - `api_calls_cost` integer
  - `data` object
    - `planning_applications` object[]
      - `url` string
      - `address` string
      - `authority` string
      - `reference` string
      - `category` string
      - `proposal` string
      - `type` string
      - `status` string
      - `decision` object
        - `text` string
        - `rating` string
      - `dates` object
        - `received_at` string
        - `decided_at` string
      - `appeals` unknown[]
        - unknown
      - `lat` number
      - `lng` number
      - `distance` string
  - `process_time` string: Server processing time in seconds

## Other responses

- `4XX`: Error response. Common codes: X02 missing key (400), X03 invalid key (422), X04 credit limit exceeded (403), X06/X07 missing or invalid location input (400/422), X08 insufficient data for location (404), X13 free trial limit exceeded (403), X14 rate limited (429), X20 server busy, retry after 60 seconds (503).

---

[API](https://skmtc.dev/propertydata/apis/propertydata-api.md) · [All operations](https://skmtc.dev/propertydata/apis/propertydata-api/llms.txt) · [OpenAPI document](https://skmtc.dev/propertydata/apis/propertydata-api/revisions/38ab011f2f4c?raw)