Income and tax by postcode
/v1/postcodes/{postcode}/economy/taxation10¢ per callIndividual tax-return statistics by postcode for each income year 2016-17 to 2023-24: taxpayers, taxable income (average and median), salary, deductions, net tax, rental income and losses, capital gains, super.
Coverage: About 2,570 postcodes across Australia; income years 2016-17 to 2023-24 (8 years). Current to 2024-06-30. Full description, field list and method: /v1/datasets/taxation.
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: individuals_count, taxable_income_count, taxable_income_total, total_income_count, total_income_total, salary_wages_count, salary_wages_total, net_tax_count, net_tax_total, medicare_levy_surcharge_count, medicare_levy_surcharge_total, help_debt_balance_count, help_debt_balance_total, govt_allowances_payments_count, govt_allowances_payments_total, govt_pensions_allowances_count, govt_pensions_allowances_total, gross_interest_count, gross_interest_total, dividends_franked_count, dividends_franked_total, work_related_expenses_count, work_related_expenses_total, work_related_car_count, work_related_car_total, work_related_self_education_count, work_related_self_education_total, interest_deductions_count, interest_deductions_total, gifts_donations_count, gifts_donations_total, total_deductions_count, total_deductions_total, reportable_employer_super_count, reportable_employer_super_total, personal_super_contributions_count, personal_super_contributions_total, net_capital_gain_count, net_capital_gain_total, gross_rent_count, gross_rent_total, rent_interest_deductions_count, rent_interest_deductions_total, rent_capital_works_count, rent_capital_works_total, rent_other_deductions_count, rent_other_deductions_total, net_rent_profit_count, net_rent_profit_total, net_rent_loss_count, net_rent_loss_total, net_rent_count, net_rent_total, business_net_income_count, business_net_income_total, private_health_insurance_count, average_taxable_income, median_taxable_income, average_salary_wages, median_salary_wages, average_net_rent, median_net_rent, average_total_income, median_total_income, average_total_deductions, median_total_deductions, average_business_income, median_business_income, average_net_tax, median_net_tax, average_super_balance, median_super_balance, share_with_net_rental_loss_pct, share_giving_to_charity_pct, share_with_private_health_insurance_pct. 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/taxationcurl --request GET \
--url 'https://api.microburbs.com.au/v1/postcodes/2280/economy/taxation' \
--header 'Authorization: Bearer test'{
"data": {
"dataset": "taxation",
"level": "postcode",
"area": "2000",
"period_type": "financial_year",
"as_of": "2024-06-30",
"modelled": false,
"fields": [
{
"field": "individuals_count",
"name": "Individuals lodging a return",
"unit": "count",
"values": [
{
"period": "2021-22",
"period_start": "2021-07-01",
"value": 22833
},
{
"period": "2022-23",
"period_start": "2022-07-01",
"value": 25285
},
{
"period": "2023-24",
"period_start": "2023-07-01",
"value": 26169
}
]
},
{
"field": "taxable_income_count",
"name": "Taxable income (people)",
"unit": "count",
"values": [
{
"period": "2021-22",
"period_start": "2021-07-01",
"value": 22278
},
{
"period": "2022-23",
"period_start": "2022-07-01",
"value": 24712
},
{
"period": "2023-24",
"period_start": "2023-07-01",
"value": 25672
}
]
},
{
"field": "taxable_income_total",
"name": "Taxable income (total)",
"unit": "$",
"values": [
{
"period": "2021-22",
"period_start": "2021-07-01",
"value": 2455997000
},
{
"period": "2022-23",
"period_start": "2022-07-01",
"value": 2419249000
},
{
"period": "2023-24",
"period_start": "2023-07-01",
"value": 2522784000
}
]
}
]
}
}About this dataset
About 2,570 postcodes across Australia; income years 2016-17 to 2023-24 (8 years). Current to 2024-06-30; refreshed yearly.
What it is
What the people living in each postcode reported on their individual tax returns, for each of the last eight income years (July to June). Around 75 fields: how many people lodged, their taxable income, salary and wages, deductions, net tax paid, rental income and rental losses, capital gains, super contributions and super balances, business income and more.
What it shows
For almost every postcode in Australia: the number of taxpayers and dollar totals for each item (for example salary and wages, total deductions, gifts and donations, net capital gain, gross rent and rental interest deductions), plus the average and median per person for the main items, and three shares: the share of people with a net rental loss (negative gearing), the share who claimed charity gifts and the share with private health insurance. Each value is for one income year, dated 1 July of the year it started (2023-24 is 2023-07-01).
Why use it
The best public measure of what people actually earn and own at postcode level, by year. Use it to profile a postcode's incomes and how fast they are growing, compare postcodes, find investor-heavy areas (high rental-loss share), rank postcodes by wealth (super balances, capital gains), or add real income figures to a lookup, report or lending/marketing model. Medians matter: averages are pulled up by a few very high earners.
How it is built
Compiled from the annual published tax-return statistics for individuals, one record per postcode and year. Postcodes that cross a state border are combined. Counts are people, dollars are whole dollars for the year, and 'average' and 'median' are per person reporting that item. Tiny postcodes are partly suppressed, so a few values can be missing for them. The figures cover people who lodged a return, which is about 98 percent of the national total (some returns have no usable postcode), so a postcode's totals are very slightly understated. Postcode areas are tax-return postcodes of residence, not the same as suburbs; use postcode-profile to see which suburbs a postcode contains.
Fields
| Field | Unit | Description |
|---|---|---|
individuals_countIndividuals lodging a return | count | Number of people living in the postcode who lodged an individual income tax return for the year. |
taxable_income_countTaxable income (people) | count | Number of people in the postcode who reported taxable income on their return for the year. |
taxable_income_totalTaxable income (total) | $ | Total dollars of taxable income reported by everyone in the postcode for the year. Losses are negative. |
total_income_countTotal income (people) | count | Number of people in the postcode who reported total income on their return for the year. |
total_income_totalTotal income (total) | $ | Total dollars of total income reported by everyone in the postcode for the year. Losses are negative. |
salary_wages_countSalary or wages (people) | count | Number of people in the postcode who reported salary or wages on their return for the year. |
salary_wages_totalSalary or wages (total) | $ | Total dollars of salary or wages reported by everyone in the postcode for the year. Losses are negative. |
net_tax_countNet tax (people) | count | Number of people in the postcode who reported net tax on their return for the year. |
net_tax_totalNet tax (total) | $ | Total dollars of net tax reported by everyone in the postcode for the year. Losses are negative. |
medicare_levy_surcharge_countMedicare levy surcharge (people) | count | Number of people in the postcode who reported medicare levy surcharge on their return for the year. |
medicare_levy_surcharge_totalMedicare levy surcharge (total) | $ | Total dollars of medicare levy surcharge reported by everyone in the postcode for the year. Losses are negative. |
help_debt_balance_countStudy loan debt balance (people) | count | Number of people in the postcode who reported study loan debt balance on their return for the year. |
help_debt_balance_totalStudy loan debt balance (total) | $ | Total dollars of study loan debt balance reported by everyone in the postcode for the year. Losses are negative. |
govt_allowances_payments_countGovernment allowances and payments (people) | count | Number of people in the postcode who reported government allowances and payments on their return for the year. |
govt_allowances_payments_totalGovernment allowances and payments (total) | $ | Total dollars of government allowances and payments reported by everyone in the postcode for the year. Losses are negative. |
govt_pensions_allowances_countGovernment pensions and allowances (people) | count | Number of people in the postcode who reported government pensions and allowances on their return for the year. |
govt_pensions_allowances_totalGovernment pensions and allowances (total) | $ | Total dollars of government pensions and allowances reported by everyone in the postcode for the year. Losses are negative. |
gross_interest_countInterest income (people) | count | Number of people in the postcode who reported interest income on their return for the year. |
gross_interest_totalInterest income (total) | $ | Total dollars of interest income reported by everyone in the postcode for the year. Losses are negative. |
dividends_franked_countFranked dividends (people) | count | Number of people in the postcode who reported franked dividends on their return for the year. |
dividends_franked_totalFranked dividends (total) | $ | Total dollars of franked dividends reported by everyone in the postcode for the year. Losses are negative. |
work_related_expenses_countWork-related expenses (people) | count | Number of people in the postcode who reported work-related expenses on their return for the year. |
work_related_expenses_totalWork-related expenses (total) | $ | Total dollars of work-related expenses reported by everyone in the postcode for the year. Losses are negative. |
work_related_car_countWork-related car expenses (people) | count | Number of people in the postcode who reported work-related car expenses on their return for the year. |
work_related_car_totalWork-related car expenses (total) | $ | Total dollars of work-related car expenses reported by everyone in the postcode for the year. Losses are negative. |
work_related_self_education_countWork-related self-education expenses (people) | count | Number of people in the postcode who reported work-related self-education expenses on their return for the year. |
work_related_self_education_totalWork-related self-education expenses (total) | $ | Total dollars of work-related self-education expenses reported by everyone in the postcode for the year. Losses are negative. |
interest_deductions_countInterest deductions (people) | count | Number of people in the postcode who reported interest deductions on their return for the year. |
interest_deductions_totalInterest deductions (total) | $ | Total dollars of interest deductions reported by everyone in the postcode for the year. Losses are negative. |
gifts_donations_countGifts and donations (people) | count | Number of people in the postcode who reported gifts and donations on their return for the year. |
gifts_donations_totalGifts and donations (total) | $ | Total dollars of gifts and donations reported by everyone in the postcode for the year. Losses are negative. |
total_deductions_countTotal deductions (people) | count | Number of people in the postcode who reported total deductions on their return for the year. |
total_deductions_totalTotal deductions (total) | $ | Total dollars of total deductions reported by everyone in the postcode for the year. Losses are negative. |
reportable_employer_super_countReportable employer super contributions (people) | count | Number of people in the postcode who reported reportable employer super contributions on their return for the year. |
reportable_employer_super_totalReportable employer super contributions (total) | $ | Total dollars of reportable employer super contributions reported by everyone in the postcode for the year. Losses are negative. |
personal_super_contributions_countPersonal super contributions (people) | count | Number of people in the postcode who reported personal super contributions on their return for the year. |
personal_super_contributions_totalPersonal super contributions (total) | $ | Total dollars of personal super contributions reported by everyone in the postcode for the year. Losses are negative. |
net_capital_gain_countNet capital gain (people) | count | Number of people in the postcode who reported net capital gain on their return for the year. |
net_capital_gain_totalNet capital gain (total) | $ | Total dollars of net capital gain reported by everyone in the postcode for the year. Losses are negative. |
gross_rent_countGross rent (people) | count | Number of people in the postcode who reported gross rent on their return for the year. |
gross_rent_totalGross rent (total) | $ | Total dollars of gross rent reported by everyone in the postcode for the year. Losses are negative. |
rent_interest_deductions_countRental interest deductions (people) | count | Number of people in the postcode who reported rental interest deductions on their return for the year. |
rent_interest_deductions_totalRental interest deductions (total) | $ | Total dollars of rental interest deductions reported by everyone in the postcode for the year. Losses are negative. |
rent_capital_works_countRental capital works deductions (people) | count | Number of people in the postcode who reported rental capital works deductions on their return for the year. |
rent_capital_works_totalRental capital works deductions (total) | $ | Total dollars of rental capital works deductions reported by everyone in the postcode for the year. Losses are negative. |
rent_other_deductions_countOther rental deductions (people) | count | Number of people in the postcode who reported other rental deductions on their return for the year. |
rent_other_deductions_totalOther rental deductions (total) | $ | Total dollars of other rental deductions reported by everyone in the postcode for the year. Losses are negative. |
net_rent_profit_countNet rent (profit) (people) | count | Number of people in the postcode who reported net rent (profit) on their return for the year. |
net_rent_profit_totalNet rent (profit) (total) | $ | Total dollars of net rent (profit) reported by everyone in the postcode for the year. Losses are negative. |
net_rent_loss_countNet rent (loss) (people) | count | Number of people in the postcode who reported net rent (loss) on their return for the year. |
net_rent_loss_totalNet rent (loss) (total) | $ | Total dollars of net rent (loss) reported by everyone in the postcode for the year. Losses are negative. |
net_rent_countNet rent (people) | count | Number of people in the postcode who reported net rent on their return for the year. |
net_rent_totalNet rent (total) | $ | Total dollars of net rent reported by everyone in the postcode for the year. Losses are negative. |
business_net_income_countNet income from business (people) | count | Number of people in the postcode who reported net income from business on their return for the year. |
business_net_income_totalNet income from business (total) | $ | Total dollars of net income from business reported by everyone in the postcode for the year. Losses are negative. |
private_health_insurance_countPeople with private health insurance (people) | count | Number of people in the postcode who reported people with private health insurance on their return for the year. |
average_taxable_incomeAverage taxable income | $ | The mean amount of taxable income per person in the postcode who reported it, in dollars, for the year. |
median_taxable_incomeMedian taxable income | $ | The middle (median) amount of taxable income per person in the postcode who reported it, in dollars, for the year. |
average_salary_wagesAverage salary or wages | $ | The mean amount of salary and wages per person in the postcode who reported it, in dollars, for the year. |
median_salary_wagesMedian salary or wages | $ | The middle (median) amount of salary and wages per person in the postcode who reported it, in dollars, for the year. |
average_net_rentAverage net rent | $ | The mean amount of net rental income per person in the postcode who reported it, in dollars, for the year. |
median_net_rentMedian net rent | $ | The middle (median) amount of net rental income per person in the postcode who reported it, in dollars, for the year. |
average_total_incomeAverage total income | $ | The mean amount of total income per person in the postcode who reported it, in dollars, for the year. |
median_total_incomeMedian total income | $ | The middle (median) amount of total income per person in the postcode who reported it, in dollars, for the year. |
average_total_deductionsAverage total deductions | $ | The mean amount of total deductions per person in the postcode who reported it, in dollars, for the year. |
median_total_deductionsMedian total deductions | $ | The middle (median) amount of total deductions per person in the postcode who reported it, in dollars, for the year. |
average_business_incomeAverage business income | $ | The mean amount of total business income per person in the postcode who reported it, in dollars, for the year. |
median_business_incomeMedian business income | $ | The middle (median) amount of total business income per person in the postcode who reported it, in dollars, for the year. |
average_net_taxAverage net tax | $ | The mean amount of net tax per person in the postcode who reported it, in dollars, for the year. |
median_net_taxMedian net tax | $ | The middle (median) amount of net tax per person in the postcode who reported it, in dollars, for the year. |
average_super_balanceAverage super balance | $ | Average total balance across the super accounts of people in the postcode, in dollars, at the end of the year. |
median_super_balanceMedian super balance | $ | Median total balance across the super accounts of people in the postcode, in dollars, at the end of the year. |
share_with_net_rental_loss_pctShare with a net rental loss | % | Percent of individuals in the postcode whose rental properties made a net loss for the year (their rent deductions exceeded rent received) - the negative-gearing share. |
share_giving_to_charity_pctShare claiming gifts and donations | % | Percent of individuals in the postcode who claimed a deduction for gifts or donations. |
share_with_private_health_insurance_pctShare with private health insurance | % | Percent of individuals in the postcode who reported holding private patient hospital cover. |