Bushfire + flood — bundle
/v1/suburbs/{suburb_name}/risks/all11¢ per callExact suburb identifier required. Exact ABS Suburb and Locality (SAL) name, e.g. Burwood (NSW) — many suburbs carry a state suffix. If starting from free text or an unverified bare name, first call GET /v1/geocode/suburb?q=<text>, then use the exact data[].area_name it returns. Suburb data endpoints do not guess a state or typo-correct names.
Price: 11¢ per call.
Authorization
Request
The only values you send. Fields under Responses below are what comes back — you never pass those.
Path parameters
suburb_namestringrequiredExact ABS Suburb and Locality (SAL) name, e.g. `Burwood (NSW)` — many suburbs carry a state suffix. If starting from free text or an unverified bare name, first call `GET /v1/geocode/suburb?q=<text>`, then use the exact `data[].area_name` it returns. Suburb data endpoints do not guess a state or typo-correct names.
Query parameters
geojsonbooleanoptionalWhen true, each sub-risk additionally carries a `geojson` FeatureCollection clipped to the suburb boundary — one call returns coverage plus every risk shape (default false — response unchanged).
Responses
Successful Response
bushfireobjectmay be nullOne suburb-level risk record (bushfire or flood). `coverage_pct` is the share of the SAL covered by the modelled risk overlay. `risk_band` is a coarse low/moderate/high band — only populated for flood today; bushfire reports the raw percentage.
floodobjectmay be nullOne suburb-level risk record (bushfire or flood). `coverage_pct` is the share of the SAL covered by the modelled risk overlay. `risk_band` is a coarse low/moderate/high band — only populated for flood today; bushfire reports the raw percentage.
/v1/suburbs/{suburb_name}/risks/allcurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/risks/all' \
--header 'Authorization: Bearer test'{
"data": {
"bushfire": {
"area_level": "suburb",
"area_name": "Belmont North",
"coverage_pct": 45.72,
"name": "Bushfire",
"value_unit": "% of suburb area"
},
"flood": {
"area_level": "suburb",
"area_name": "Belmont North",
"coverage_pct": 7.2,
"name": "Flood",
"risk_band": "moderate",
"value_unit": "% of suburb area"
}
}
}