Suburb - Demographics

Population history & projection

GET/v1/suburbs/{suburb_name}/demographics/population-history10¢ per call

Suburb census population points (2011/2016/2021) plus the LGA's yearly population series with a 10-year modelled projection tail.

Price: 10¢ per call.

Authorization

Bearer tokentest

Sandbox key test works for the allowlisted GNAF + SAL — no signup.

Request

The only values you send. Fields under Responses below are what comes back — you never pass those.

Path parameters

suburb_namestringrequired

Query parameters

None — this endpoint accepts no query parameters. Call the path above with your bearer token and nothing else.

Responses

Successful Response

application/json

PopulationHistoryfields returned to you

suburbstringalways returned

Canonical SAL name.

lgastringmay be null

The suburb's LGA name.

current_populationintegermay be null

Current residents (ABS Census 2021, mesh-block sum).

microburb_countintegermay be null

Residential microburbs (mesh blocks) in the suburb.

census_yearintegeralways returned

Census year of current_population.

suburb_seriesarray of PopulationPointalways returned

Suburb census points (2011/2016/2021 where available).

lga_seriesarray of LgaPopulationPointalways returned

LGA yearly series — ABS ERP history (projected=false) plus a 10-year interpolated projection tail (projected=true).

suburb_growthobjectmay be null

Start → end growth summary over a population series.

lga_growthobjectmay be null

Start → end growth summary over a population series.

lga_projectionobjectmay be null

LGA 10-year projection summary.

GET/v1/suburbs/{suburb_name}/demographics/population-history

cURL

curl --request GET \
  --url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/demographics/population-history' \
  --header 'Authorization: Bearer test'

Example Responses

Show schema

{
  "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
      }
    ]
  }
}

Successful Response200

application/json