Total population, history & projection
/v1/suburbs/{suburb_name}/demographics/population-history10¢ per callTotal suburb population is current_population (ABS Census 2021),
alongside suburb census points (2011/2016/2021) and the LGA's yearly
population series with a 10-year modelled projection tail. Use this route
for questions such as "what is the total population of Clarkson?
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
suburbstringalways returnedCanonical SAL name.
lgastringmay be nullThe suburb's LGA name.
current_populationintegermay be nullCurrent residents (ABS Census 2021, mesh-block sum).
microburb_countintegermay be nullResidential microburbs (mesh blocks) in the suburb.
census_yearintegeralways returnedCensus year of current_population.
suburb_seriesarray of PopulationPointalways returnedSuburb census points (2011/2016/2021 where available).
lga_seriesarray of LgaPopulationPointalways returnedLGA yearly series — ABS ERP history (projected=false) plus a 10-year interpolated projection tail (projected=true).
suburb_growthobjectmay be nullStart → end growth summary over a population series.
lga_growthobjectmay be nullStart → end growth summary over a population series.
lga_projectionobjectmay be nullLGA 10-year projection summary.
/v1/suburbs/{suburb_name}/demographics/population-historycurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/demographics/population-history' \
--header 'Authorization: Bearer test'{
"data": {
"census_year": 2021,
"current_population": 6302,
"lga": "Lake Macquarie",
"lga_growth": {
"end_population": 219000,
"end_year": 2025,
"pct_change": 9,
"start_population": 201000,
"start_year": 2015
},
"lga_projection": {
"pct_change": 12.2,
"source": "MIB",
"to_year": 2035
},
"lga_series": [
{
"population": 216983,
"projected": false,
"year": 2024
},
{
"population": 219000,
"projected": false,
"year": 2025
},
{
"population": 221672,
"projected": true,
"year": 2026
}
],
"microburb_count": 77,
"suburb": "Belmont North",
"suburb_growth": {
"end_population": 6302,
"end_year": 2021,
"pct_change": 3.5,
"start_population": 6086,
"start_year": 2011
},
"suburb_series": [
{
"population": 6086,
"year": 2011
},
{
"population": 6338,
"year": 2016
},
{
"population": 6302,
"year": 2021
}
]
}
}