Dwelling & population density
/v1/suburbs/{suburb_name}/development/density5¢ per callDwellings and people per km², plus the land area and counts behind them.
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: 5¢ 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'.
dwellings_per_km2integermay be nullDwelling density from the Microburbs suburb profile — the figure the suburb report headlines. Measured around the suburb's properties, so it differs from `boundary_dwellings_per_km2`. Null for suburbs with no profile row (mostly rural / non-residential SALs).
people_per_km2integermay be nullPopulation density from the same suburb profile, on the same denominator as `dwellings_per_km2`.
density_levelstringmay be nullBand the report labels `dwellings_per_km2` with: Low (<1,000), Mid (1,000–2,999), High (3,000+).
area_km2numbermay be nullLand area of the ABS SAL boundary in km², summed from the equal-area mesh-block areas ABS publishes.
dwellingsintegermay be nullCensus dwelling count across the suburb's mesh blocks.
populationintegermay be nullCensus usual-resident population across the suburb's mesh blocks.
boundary_dwellings_per_km2numbermay be null`dwellings / area_km2` — the whole-of-boundary ratio.
boundary_people_per_km2numbermay be null`population / area_km2` — the whole-of-boundary ratio.
/v1/suburbs/{suburb_name}/development/densitycurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/development/density' \
--header 'Authorization: Bearer test'{
"data": {
"area_name": "Belmont North",
"area_level": "suburb",
"dwellings_per_km2": 1002,
"people_per_km2": 2575,
"density_level": "Mid",
"area_km2": 3.6314,
"dwellings": 2453,
"population": 6280,
"boundary_dwellings_per_km2": 675.5,
"boundary_people_per_km2": 1729.4
}
}