Income-bracket breakdown
/v1/suburbs/{suburb_name}/demographics/income3¢ per callHousehold income breakdown by bracket.
Exact 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: 3¢ 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
Responses
Successful Response
area_namestringalways returnedSuburb (SAL) name.
area_levelstringalways returnedAlways 'suburb'.
proportionnumbermay be nullShare of the suburb in this bracket (0–1).
age_bracketstringmay be nullOnly on /demographics/age.
genderstringmay be nullOnly on /demographics/age — 'males' / 'females' / 'persons'.
income_bracketstringmay be nullOnly on /demographics/income.
median_incomeintegermay be nullOnly on /demographics/income.
/v1/suburbs/{suburb_name}/demographics/incomecurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/demographics/income' \
--header 'Authorization: Bearer test'{
"data": [
{
"area_name": "Belmont North",
"area_level": "suburb",
"income_bracket": ">$156k",
"proportion": 0.0287,
"median_income": 90480
},
{
"area_name": "Belmont North",
"area_level": "suburb",
"income_bracket": "$65k-$155k",
"proportion": 0.256,
"median_income": 90480
},
{
"area_name": "Belmont North",
"area_level": "suburb",
"income_bracket": "$33k-$64k",
"proportion": 0.268,
"median_income": 90480
}
]
}