Built-year profile
/v1/suburbs/{suburb_name}/market/built-year10¢ per callEstimated build-year profile — suburb aggregate + per-mesh-block medians.
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: 10¢ 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' for these endpoints.
median_yrintegermay be nullSuburb median build year (median of MB medians).
p10_yrintegermay be nullEarliest MB 10th-percentile year (range floor).
p90_yrintegermay be nullLatest MB 90th-percentile year (range ceiling).
modal_erastringmay be nullDominant era label across MBs, e.g. '1980_1999'.
n_propsintegermay be nullTotal properties behind the aggregate.
n_mbsintegermay be nullMesh blocks with build-year data.
mbsarray of BuiltYearMbalways returnedPer-mesh-block estimates.
/v1/suburbs/{suburb_name}/market/built-yearcurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/market/built-year' \
--header 'Authorization: Bearer test'{
"data": {
"area_level": "suburb",
"area_name": "Belmont North",
"mbs": [
{
"mb": "10439043000",
"median_yr": 1991,
"modal_era": "1980_1999",
"n_props": 61,
"p10_yr": 1980,
"p90_yr": 2000
}
],
"median_yr": 1979,
"modal_era": "1980_1999",
"n_mbs": 78,
"n_props": 3405,
"p10_yr": 1955,
"p90_yr": 2010
}
}