Outages in a suburb

Two calls: find the suburb's id, then filter by it.

1. Find the suburb

curl -H "Authorization: Bearer $AOT_API_KEY" \
  "https://api.aussieoutagetracker.com.au/v1/suburbs?q=cranb&limit=2"

{
  "data": [
    {
      "id": 7904,
      "name": "Cranbourne",
      "postcode": "3977",
      "state": "vic",
      "url": "https://aussieoutagetracker.com.au/locations/vic/power/cranbourne-3977/",
      "networks": [
        "ausnet"
      ]
    },
    {
      "id": 7903,
      "name": "Cranbourne East",
      "postcode": "3977",
      "state": "vic",
      "url": "https://aussieoutagetracker.com.au/locations/vic/power/cranbourne-east-3977/",
      "networks": [
        "ausnet"
      ]
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJzIjoibmFtZSIsInYiOiJjcmFuYm91cm5lIGVhc3QiLCJpIjo3OTAzfQ",
    "limit": 2
  },
  "meta": {
    "data_as_of": "2026-10-20T02:28:26.234Z"
  }
}

q is a case-insensitive prefix match on the name, so cranb finds Cranbourne and Cranbourne East. Narrow it with state or postcode when a name is shared — there is a Richmond in three states. Each suburb lists the networks that serve it, where known, and the url of its public page.

Suburb ids are stable; look one up once and keep it.

2. Filter by it

curl -H "Authorization: Bearer $AOT_API_KEY" \
  "https://api.aussieoutagetracker.com.au/v1/outages?suburb=7904&from=2026-09-30T14:00:00Z"

Add status=active for what is off there now, or from and to for a window of the archive. One query reads up to 31 days of start times, so from alone, as here, reads the 31 days after it.

suburb or postcode?

They answer different questions:

• suburb= uses Aussie Outage Tracker's attribution rule: the network's own named localities where it gives a town and a postcode, and the outage's shape where it does not. It works for every network, including the ones that never publish a postcode.
• postcode= matches only outages whose network listed that postcode among the affected localities. Networks that publish no postcodes never match, however close the outage was.

Use suburb unless you specifically want the network's own postcode list. Places and attribution explains the rule in full.

From an outage to its suburbs

The other direction is on the outage itself: GET/v1/outages/{id} returns suburbs, every suburb the outage is attributed to by the same rule, each with its id and public page.