New-dwelling applications by mesh block (by suburb)
/v1/suburbs/{suburb_name}/development/new-dwellings-map20¢ per callHow many development applications for new dwellings were lodged in each
microburb (mesh block) of the suburb, from the newest 2,000 applications.
Every block is listed, 0 where none were. The individual applications are
at /development/applications. Values only; polygons come from
/shapes/mesh-blocks.
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: 20¢ 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
suburbstringalways returnedCanonical SAL name.
metricstringalways returnedAlways 'new_dwelling_applications'.
unitstringalways returnedAlways 'applications'.
definitionstringalways returnedHow the figure is derived.
total_new_dwelling_applicationsintegeralways returnedNew-dwelling applications in the suburb, located or not.
placed_new_dwelling_applicationsintegeralways returnedThose located inside one of the suburb's mesh blocks.
active_blocksintegeralways returnedMicroburbs with at least one application.
n_microburbsintegeralways returnedMicroburbs in the suburb.
microburbsarray of NewDwellingsMbalways returnedEvery microburb, 0 where none were lodged, by mesh-block code.
/v1/suburbs/{suburb_name}/development/new-dwellings-mapcurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/development/new-dwellings-map' \
--header 'Authorization: Bearer test'{
"data": {
"suburb": "Belmont North",
"metric": "new_dwelling_applications",
"unit": "applications",
"definition": "Development applications for new dwellings lodged in the suburb, counted per mesh block ('microburb', ~30-60 dwellings) by where each one is located. Every block is listed, 0 where none were lodged. Applications without a location count in `total_new_dwelling_applications` but not on any block. The newest 2,000 applications are read.",
"total_new_dwelling_applications": 9,
"placed_new_dwelling_applications": 9,
"active_blocks": 4,
"n_microburbs": 85,
"microburbs": [
{
"mb": "10431210000",
"street": "Wommara",
"new_dwelling_applications": 2
}
]
}
}