Microburbs
Microburbs API
Free sandbox: try any request below on the sample suburbs, no signup. For every suburb, create an API key.
Classic docs
Microburbs Property Data API
Postcode - Economy

Taxpayers by age band by postcode

GET/v1/postcodes/{postcode}/economy/taxpayer-age5¢ per call

How many people lodging a tax return in each postcode are in each of six age bands, per income year 2016-17 to 2023-24.

Coverage: About 2,530 postcodes; income years 2016-17 to 2023-24. Current to 2024-06-30. Full description, field list and method: /v1/datasets/taxpayer-age.

Authorization

Request

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

Path parameters

postcodestringrequired

Four-digit postcode, e.g. `2026`.

Query parameters

fieldsstringoptional

Comma-separated subset of: age_under_25, age_25_34, age_35_44, age_45_54, age_55_64, age_65_plus. Omit for all.

fromstringoptional

First period to include: 2020, 2020-Q3, 2020-07 or 2020-07-01.

tostringoptional

Last period to include, same formats as `from`.

Responses

Successful Response

application/json
DatasetValuesfields returned to you
datasetstringalways returned

Dataset slug; describe it with /v1/datasets/{slug}.

levelstringalways returned

suburb, lga or block.

areastringalways returned

Canonical name (or mesh-block code) of the area answered.

period_typestringalways returned

snapshot, year, financial_year, quarter or month.

as_ofstring · datealways returned

Date the dataset is current to. Values are never withheld for age; check this instead.

modelledbooleanalways returned

True when the figures are estimates from a model rather than counts or measurements.

fieldsarray of DatasetFieldSeriesalways returned
GET/v1/postcodes/{postcode}/economy/taxpayer-age
cURL
curl --request GET \
  --url 'https://api.microburbs.com.au/v1/postcodes/2280/economy/taxpayer-age' \
  --header 'Authorization: Bearer test'
Example Responses
{
  "data": {
    "dataset": "taxpayer-age",
    "level": "postcode",
    "area": "3000",
    "period_type": "financial_year",
    "as_of": "2024-06-30",
    "modelled": false,
    "fields": [
      {
        "field": "age_under_25",
        "name": "Taxpayers aged under 25",
        "unit": "count",
        "values": [
          {
            "period": "2021-22",
            "period_start": "2021-07-01",
            "value": 8295
          },
          {
            "period": "2022-23",
            "period_start": "2022-07-01",
            "value": 10125
          },
          {
            "period": "2023-24",
            "period_start": "2023-07-01",
            "value": 10677
          }
        ]
      },
      {
        "field": "age_25_34",
        "name": "Taxpayers aged 25 to 34",
        "unit": "count",
        "values": [
          {
            "period": "2021-22",
            "period_start": "2021-07-01",
            "value": 15464
          },
          {
            "period": "2022-23",
            "period_start": "2022-07-01",
            "value": 18240
          },
          {
            "period": "2023-24",
            "period_start": "2023-07-01",
            "value": 19733
          }
        ]
      },
      {
        "field": "age_35_44",
        "name": "Taxpayers aged 35 to 44",
        "unit": "count",
        "values": [
          {
            "period": "2021-22",
            "period_start": "2021-07-01",
            "value": 5174
          },
          {
            "period": "2022-23",
            "period_start": "2022-07-01",
            "value": 5443
          },
          {
            "period": "2023-24",
            "period_start": "2023-07-01",
            "value": 5660
          }
        ]
      }
    ]
  }
}
Successful Response200
application/json

About this dataset

About 2,530 postcodes; income years 2016-17 to 2023-24. Current to 2024-06-30; refreshed yearly.

What it is

The number of people who lodged an individual tax return, by postcode and age band (under 25, 25-34, 35-44, 45-54, 55-64, 65 and over), for each income year 2016-17 to 2023-24.

What it shows

Counts of people per age band per postcode per year. The six bands add up to everyone lodging in the postcode. Age is at the end of the income year.

Why use it

A current, year-by-year age profile of the working and retired population of a postcode (people who earn enough or have to lodge): spot postcodes that are ageing or filling with under-35s, size a market by age, or pair it with income brackets. It updates every year, between population surveys.

How it is built

Compiled from the annual published tax-return statistics for individuals, counting by postcode of residence and age. It covers lodgers, not the whole population: children and many non-earners do not lodge, so totals are lower than resident population. Postcodes crossing state borders are combined.

Fields

FieldUnitDescription
age_under_25
Taxpayers aged under 25
countNumber of people aged under 25 who lodged an individual tax return for the year, living in the postcode.
age_25_34
Taxpayers aged 25 to 34
countNumber of people aged 25 to 34 who lodged an individual tax return for the year, living in the postcode.
age_35_44
Taxpayers aged 35 to 44
countNumber of people aged 35 to 44 who lodged an individual tax return for the year, living in the postcode.
age_45_54
Taxpayers aged 45 to 54
countNumber of people aged 45 to 54 who lodged an individual tax return for the year, living in the postcode.
age_55_64
Taxpayers aged 55 to 64
countNumber of people aged 55 to 64 who lodged an individual tax return for the year, living in the postcode.
age_65_plus
Taxpayers aged 65 and over
countNumber of people aged 65 and over who lodged an individual tax return for the year, living in the postcode.