List councils

Every council we hold applications for, with a count. Free.

Returns every local planning authority we hold applications for, alphabetically, with how many we hold. Use the authority value as the authority filter on /api/v1/applications.

Free: uses no records. The list is refreshed at most once an hour, so cache it on your side too.

• Access: All plans, including the free demo.
• Records: free, uses none.
• MCP: the list_authorities tool calls this endpoint. See MCP for developers.

Parameters

None.

Example request

curl "https://planningsignal.co.uk/api/v1/authorities" \
  -H "Authorization: Bearer ps_live_your_key_here"

Example response

{
  "data": [
    {
      "authority": "Camden",
      "count": 15310
    },
    {
      "authority": "Leeds",
      "count": 21877
    },
    {
      "authority": "Westminster",
      "count": 18452
    }
  ]
}

Errors

Every error has the same JSON shape: { "error": "...", "code": "..." }, with extra fields on some codes. Full bodies are on rate limits and errors.