Forecast by mesh block — modelled outlook (by suburb) (beta)
/v1/suburbs/{suburb_name}/mesh-blocks/forecast20¢ per callBeta. The figures behind this topic have not been validated against an independent source, so it is not sold at the same confidence as the other mesh-block topics. Every response says beta: true and carries a beta_notice.
What's the outlook? Modelled forecasts for every mesh block in the suburb: owner-occupation in 2026, capital growth, the chance of a rezoning within five years, and future building height.
One entry per mesh block in the suburb under mesh_blocks, each with its mb_code, population and dwellings. Values only — the matching polygons come from /shapes/mesh-blocks.
Every field carries provenance — measured (at this block), measured_wider_area (measured for the SA1 or postcode and repeated on every block in it), estimate (our model) or not_recorded — plus how, one sentence on how the number was arrived at.
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 returnedSuburb (SAL) name, as resolved.
statestringmay be nullState / Territory abbreviation.
topicstringalways returnedWhich topic this answers.
questionstringalways returnedThe question this topic answers.
betabooleanalways returned`true` when the figures behind this topic have not been validated against an independent source yet.
beta_noticestringmay be nullWhat is unvalidated, on beta topics only.
block_countintegeralways returnedHow many mesh blocks are in `mesh_blocks`.
mesh_blocksarray of MbTopicBlockalways returnedOne entry per mesh block in the suburb, ordered by `mb_code`.
notestringalways returnedHow to read `provenance`.
/v1/suburbs/{suburb_name}/mesh-blocks/forecastcurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/mesh-blocks/forecast' \
--header 'Authorization: Bearer test'{
"data": {
"suburb": "Belmont North",
"state": "NSW",
"topic": "forecast",
"question": "What's the outlook?",
"beta": true,
"beta_notice": "Beta: this topic has not been validated against an independent source yet. Check each field's provenance before presenting a figure as a measurement.",
"block_count": 85,
"mesh_blocks": [
{
"mb_code": "10434270000",
"population": 124,
"dwellings": 46,
"fields": {
"owned_outright_2026_pct": {
"value": 29.23,
"label": "Homes owned outright, forecast for 2026",
"unit": "% of homes",
"provenance": "estimate",
"how": "our estimate for this Microburb"
},
"capital_growth_forecast_pct": {
"value": 8.65,
"label": "Forecast capital growth",
"unit": "% a year",
"provenance": "estimate",
"how": "our estimate for this Microburb"
},
"rezoning_probability_5y_pct": {
"value": 21.08,
"label": "Chance of a rezoning within five years",
"unit": "%",
"provenance": "estimate",
"how": "our estimate for this Microburb"
},
"future_mean_storeys": {
"value": 1.02,
"label": "Forecast average storeys",
"unit": "storeys",
"provenance": "estimate",
"how": "our estimate for this Microburb"
}
}
},
{
"mb_code": "11205004200",
"population": 189,
"dwellings": 63,
"fields": {
"owned_outright_2026_pct": {
"value": 38.99,
"label": "Homes owned outright, forecast for 2026",
"unit": "% of homes",
"provenance": "estimate",
"how": "our estimate for this Microburb"
},
"capital_growth_forecast_pct": {
"value": 6.78,
"label": "Forecast capital growth",
"unit": "% a year",
"provenance": "estimate",
"how": "our estimate for this Microburb"
},
"rezoning_probability_5y_pct": {
"value": 34.05,
"label": "Chance of a rezoning within five years",
"unit": "%",
"provenance": "estimate",
"how": "our estimate for this Microburb"
},
"future_mean_storeys": {
"value": 1.02,
"label": "Forecast average storeys",
"unit": "storeys",
"provenance": "estimate",
"how": "our estimate for this Microburb"
}
}
},
{
"mb_code": "10436570000",
"population": 169,
"dwellings": 64,
"fields": {
"owned_outright_2026_pct": {
"value": 45.52,
"label": "Homes owned outright, forecast for 2026",
"unit": "% of homes",
"provenance": "estimate",
"how": "our estimate for this Microburb"
},
"capital_growth_forecast_pct": {
"value": 6.79,
"label": "Forecast capital growth",
"unit": "% a year",
"provenance": "estimate",
"how": "our estimate for this Microburb"
},
"rezoning_probability_5y_pct": {
"value": 62.32,
"label": "Chance of a rezoning within five years",
"unit": "%",
"provenance": "estimate",
"how": "our estimate for this Microburb"
},
"future_mean_storeys": {
"value": 1.03,
"label": "Forecast average storeys",
"unit": "storeys",
"provenance": "estimate",
"how": "our estimate for this Microburb"
}
}
}
],
"note": "Each field says how its number was arrived at. An estimate is not a measurement, and a figure measured for a wider area is not a measurement of the block."
}
}