Taxpayers by income bracket by postcode
/v1/postcodes/{postcode}/economy/income-distribution5¢ per callHow many taxpayers in each postcode fall into each of five taxable-income brackets, 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/income-distribution.
Authorization
Request
The only values you send. Fields under Responses below are what comes back — you never pass those.
Path parameters
postcodestringrequiredFour-digit postcode, e.g. `2026`.
Query parameters
fieldsstringoptionalComma-separated subset of: bracket_1, bracket_2, bracket_3, bracket_4, bracket_5. Omit for all.
fromstringoptionalFirst period to include: 2020, 2020-Q3, 2020-07 or 2020-07-01.
tostringoptionalLast period to include, same formats as `from`.
Responses
Successful Response
datasetstringalways returnedDataset slug; describe it with /v1/datasets/{slug}.
levelstringalways returnedsuburb, lga or block.
areastringalways returnedCanonical name (or mesh-block code) of the area answered.
period_typestringalways returnedsnapshot, year, financial_year, quarter or month.
as_ofstring · datealways returnedDate the dataset is current to. Values are never withheld for age; check this instead.
modelledbooleanalways returnedTrue when the figures are estimates from a model rather than counts or measurements.
fieldsarray of DatasetFieldSeriesalways returned/v1/postcodes/{postcode}/economy/income-distributioncurl --request GET \
--url 'https://api.microburbs.com.au/v1/postcodes/2280/economy/income-distribution' \
--header 'Authorization: Bearer test'{
"data": {
"dataset": "income-distribution",
"level": "postcode",
"area": "3000",
"period_type": "financial_year",
"as_of": "2024-06-30",
"modelled": false,
"fields": [
{
"field": "bracket_1",
"name": "Taxpayers in the lowest bracket",
"unit": "count",
"values": [
{
"period": "2021-22",
"period_start": "2021-07-01",
"value": 9645
},
{
"period": "2022-23",
"period_start": "2022-07-01",
"value": 11533
},
{
"period": "2023-24",
"period_start": "2023-07-01",
"value": 11841
}
]
},
{
"field": "bracket_2",
"name": "Taxpayers in the second bracket",
"unit": "count",
"values": [
{
"period": "2021-22",
"period_start": "2021-07-01",
"value": 9502
},
{
"period": "2022-23",
"period_start": "2022-07-01",
"value": 10921
},
{
"period": "2023-24",
"period_start": "2023-07-01",
"value": 12945
}
]
},
{
"field": "bracket_3",
"name": "Taxpayers in the third bracket",
"unit": "count",
"values": [
{
"period": "2021-22",
"period_start": "2021-07-01",
"value": 11580
},
{
"period": "2022-23",
"period_start": "2022-07-01",
"value": 13069
},
{
"period": "2023-24",
"period_start": "2023-07-01",
"value": 13052
}
]
}
]
}
}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 in each postcode whose taxable income falls in each of five brackets, for each income year from 2016-17 to 2023-24. Five fields, one per bracket, lowest to highest.
What it shows
Counts of people (not dollars): bracket_1 is $18,200 or less, bracket_5 is over $180,000, and the three in between follow the national tax brackets of the day. The middle thresholds were raised by tax reform, so for 2016-17 and 2017-18 they are $37,000 / $80,000, for 2018-19 and 2019-20 $37,000 / $90,000 and from 2020-21 $45,000 / $120,000. Each field's description lists them. The five brackets add up to everyone who lodged in the postcode.
Why use it
Averages hide shape: two postcodes can have the same average income with very different mixes. Use the brackets to show how many high earners or low-income households an area has, build an income histogram for a postcode page, or find areas with a large share over $180,000 for premium products.
How it is built
Compiled from the annual published tax-return statistics for individuals, counting people by their taxable income bracket and postcode of residence. Postcodes crossing state borders are combined. Small cells are not suppressed in counts but tiny postcodes can be absent. To compare years, use the bracket shares rather than raw counts, and remember that bracket edges moved between 2019-20 and 2020-21.
Fields
| Field | Unit | Description |
|---|---|---|
bracket_1Taxpayers in the lowest bracket | count | Number of people whose taxable income was $18,200 or less (the tax-free threshold) in the year. |
bracket_2Taxpayers in the second bracket | count | Number of people whose taxable income was above $18,200 and up to the second threshold: $37,000 (2016-17 to 2019-20) or $45,000 (2020-21 onward). |
bracket_3Taxpayers in the third bracket | count | Number of people whose taxable income was above the second threshold and up to $80,000 (2016-17, 2017-18), $90,000 (2018-19, 2019-20) or $120,000 (2020-21 onward). |
bracket_4Taxpayers in the fourth bracket | count | Number of people whose taxable income was above the third threshold and up to $180,000: from $80,001 (2016-17, 2017-18), $90,001 (2018-19, 2019-20) or $120,001 (2020-21 onward). |
bracket_5Taxpayers in the top bracket | count | Number of people whose taxable income was above $180,000. |