Skip to content
Planning Alerts
Notice · For developers
JSON API

Planning applications, by API

The same council data behind our email alerts, as JSON. Search near any point, look up a single application, or list the councils we cover.

Free plan: 1,001 requests a day. No card needed.

Plans

Start free. Pay when you need more

Every plan covers the same data. The difference is how many requests you can make a day.

Free

$0a month

For trying the API and small projects.

  • 1,001 requests a day per key
  • Up to 1,001 results per request
  • Every council we cover
  • JSON responses
Get my free API key

No credit card needed.

Pro

$1,925AUD a month

For products and teams that rely on the data.

  • 5,001 requests a day per key
  • Up to 1,001 results per request
  • Every council we cover
  • JSON responses
  • Priority email and phone support
  • Dedicated account manager

Billed monthly through Stripe. Cancel any time.

Max

Custom

Custom volume and support. Talk to us about pricing.

  • Custom request volume
  • Every council we cover
  • JSON responses
  • Dedicated account manager
  • SLA support
  • Custom integrations
  • Onboarding help

Documentation

API reference

Everything you need to start making requests.

Base URL and authentication

All requests go to:

https://api.planningalerts.com.au

Send your API key with every request, in either header. Keep keys on your server: never put them in code that runs in a browser.

Headers
# Recommended
Authorization: Bearer pa_live_...

# Or
X-API-Key: pa_live_...

Endpoints

Get

/api/applications

Applications near a point, newest first
Query parameters for /api/applications
ParameterWhat it does
latrequiredLatitude of the centre point, in decimal degrees.
lngrequiredLongitude of the centre point.
radiusMetres around the point, 100 to 20,000. Default 2,000.
statusOnly applications whose status contains this text, e.g. approved.
year_fromOnly applications received in this year or later, e.g. 2025. Default: five years ago.
limitResults per page, 1 to 1,001. Default 100.
offsetResults to skip, for paging. Default 0.
Example
curl -H "Authorization: Bearer pa_live_YOUR_KEY" \
  "https://api.planningalerts.com.au/api/applications?lat=-33.8688&lng=151.2093&radius=1000&limit=10"
Get

/api/applications/:id

One application, with its published comments
Example
curl -H "Authorization: Bearer pa_live_YOUR_KEY" \
  "https://api.planningalerts.com.au/api/applications/4821337"
Get

/api/councils

Every council, with how many applications we hold and when we last collected data
Example
curl -H "Authorization: Bearer pa_live_YOUR_KEY" \
  "https://api.planningalerts.com.au/api/councils"

Responses

Responses are JSON. Lists come back as data plus a meta block describing the search:

GET /api/applications
{
  "data": [
    {
      "id": 4821337,
      "council_reference": "DA/2026/0412",
      "council_lga_id": 17200,
      "council_name": "City of Sydney",
      "state_abbreviation": "NSW",
      "address": "123 Example Street, Sydney NSW 2000",
      "description": "Alterations and additions to a terrace house",
      "latitude": -33.8712,
      "longitude": 151.2061,
      "status": "Under Assessment",
      "traffic_light": "AMBER",
      "date_received": "15/09/2026",
      "application_type": null,
      "info_url": "https://…",
      "merge_week": "2026-09-16",
      "distance_metres": 412.37,
      "distanceMetres": 412
    }
  ],
  "meta": {
    "total": 1,
    "lat": -33.8688,
    "lng": 151.2093,
    "radius": 1000,
    "year_from": null,
    "limit": 10,
    "offset": 0,
    "hasMore": false
  }
}
  • meta.total is the number of results in this page, not a full count. Keep paging with offset while hasMore is true.
  • date_received is as the council published it, usually DD/MM/YYYY.
  • traffic_light is a rough status group: GREEN, AMBER, RED, PURPLE (no status yet) or UNKNOWN. status is the council’s own wording.
  • merge_week is the day we last collected the record. description and info_url can be empty.

Limits and errors

Each key has a daily quota (1,001 requests on Free, 5,001 on Pro) that resets at midnight UTC. Every successful response says where you’re up to:

Response headers
X-RateLimit-Limit: 1001
X-RateLimit-Remaining: 999
X-RateLimit-Plan: FREE
400
A parameter is missing or out of range. The body explains which.
401
No API key, or the key is wrong or has been revoked.
404
No application with that id.
429
Too many requests: either the daily quota is used up (the body says so), or too many in a short burst. For a burst, wait the number of seconds in the Retry-After header.

Questions

Frequently asked questions

How do I get an API key?

Sign in or create a free account (it only needs your email address), then open My places → Developer and generate a key. Free keys are made instantly, with no credit card. If you’re on Pro, your keys already have the higher limit.

Can I upgrade or downgrade my plan?

Yes, it’s all self-service. To upgrade, use Start my Pro plan on this page or Upgrade to Pro in My places → Developer. Your limit goes up as soon as the payment is confirmed. To downgrade or cancel, use Manage billing in the same place. It opens Stripe’s billing page, where you can cancel, change your plan or update your card. Cancelling takes effect at the end of your billing period, so you keep Pro until then.

Is there a free trial of Pro?

We don’t offer automatic trials, but we’re happy to talk about one for serious use. Get in touch.

What happens to my key if I cancel?

It keeps the Pro limit until the end of your paid period, then drops back to the Free limit of 1,001 requests a day. It doesn’t stop working. You can resubscribe any time to get Pro limits back.

How is usage counted?

Each HTTP request to the API counts as one request, however many results it returns. Counts reset at midnight UTC. You can see each key’s requests for today in My places → Developer. Need more? Ask us about the Max plan.

How many results can I get per request?

Up to 1,001. Use limit and offset to page through more. For broad searches, a smaller radius or a later year_from cuts the number of pages, and saves your daily quota.

Need something bigger?

More than 5,001 requests a day, or a custom integration: tell us what you’re building.

Just want alerts for your own street? They’re free and need no API. Get free alerts

Talk to us