Taxpayers by occupation by postcode
/v1/postcodes/{postcode}/economy/taxpayer-occupation5¢ per callHow many people lodging a tax return in each postcode work in each of nine occupation groups (plus not stated), per income year 2018-19 to 2023-24.
Coverage: About 2,530 postcodes; income years 2018-19 to 2023-24. Current to 2024-06-30. Full description, field list and method: /v1/datasets/taxpayer-occupation.
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: occ_not_stated, occ_managers, occ_professionals, occ_technicians_trades, occ_community_personal_service, occ_clerical_admin, occ_sales, occ_machinery_drivers, occ_labourers, occ_apprentices_trainees. 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/taxpayer-occupationcurl --request GET \
--url 'https://api.microburbs.com.au/v1/postcodes/2280/economy/taxpayer-occupation' \
--header 'Authorization: Bearer test'{
"data": {
"dataset": "taxpayer-occupation",
"level": "postcode",
"area": "2000",
"period_type": "financial_year",
"as_of": "2024-06-30",
"modelled": false,
"fields": [
{
"field": "occ_not_stated",
"name": "Occupation not stated",
"unit": "count",
"values": [
{
"period": "2021-22",
"period_start": "2021-07-01",
"value": 4191
},
{
"period": "2022-23",
"period_start": "2022-07-01",
"value": 4447
},
{
"period": "2023-24",
"period_start": "2023-07-01",
"value": 4764
}
]
},
{
"field": "occ_managers",
"name": "Managers",
"unit": "count",
"values": [
{
"period": "2021-22",
"period_start": "2021-07-01",
"value": 2963
},
{
"period": "2022-23",
"period_start": "2022-07-01",
"value": 2983
},
{
"period": "2023-24",
"period_start": "2023-07-01",
"value": 2936
}
]
},
{
"field": "occ_professionals",
"name": "Professionals",
"unit": "count",
"values": [
{
"period": "2021-22",
"period_start": "2021-07-01",
"value": 4176
},
{
"period": "2022-23",
"period_start": "2022-07-01",
"value": 3957
},
{
"period": "2023-24",
"period_start": "2023-07-01",
"value": 3694
}
]
}
]
}
}About this dataset
About 2,530 postcodes; income years 2018-19 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 the occupation group they declared, for each income year 2018-19 to 2023-24. Ten fields: nine occupation groups and 'not stated'.
What it shows
Counts of people per occupation group per postcode per year: managers, professionals, technicians and trades workers, community and personal service workers, clerical and administrative workers, sales workers, machinery operators and drivers, labourers, and apprentices and trainees. 'Not stated' covers retirees, people with no occupation on their return and those who left it blank, so it is often large.
Why use it
Shows what kind of work a postcode does: trades-heavy outer suburbs, professional inner cities, service-worker hubs. Use it to profile a postcode's workforce, target trade or professional products, or track the growth of professionals versus trades over time.
How it is built
Compiled from the annual published tax-return statistics for individuals, counting people by the occupation group declared on their return and their postcode of residence. The groups are the national one-digit occupation classification. Postcodes crossing state borders are combined. Not published before 2018-19.
Fields
| Field | Unit | Description |
|---|---|---|
occ_not_statedOccupation not stated | count | Number of people in the postcode who lodged a tax return with occupation group 'occupation not stated' for the year. |
occ_managersManagers | count | Number of people in the postcode who lodged a tax return with occupation group 'managers' for the year. |
occ_professionalsProfessionals | count | Number of people in the postcode who lodged a tax return with occupation group 'professionals' for the year. |
occ_technicians_tradesTechnicians and trades workers | count | Number of people in the postcode who lodged a tax return with occupation group 'technicians and trades workers' for the year. |
occ_community_personal_serviceCommunity and personal service workers | count | Number of people in the postcode who lodged a tax return with occupation group 'community and personal service workers' for the year. |
occ_clerical_adminClerical and administrative workers | count | Number of people in the postcode who lodged a tax return with occupation group 'clerical and administrative workers' for the year. |
occ_salesSales workers | count | Number of people in the postcode who lodged a tax return with occupation group 'sales workers' for the year. |
occ_machinery_driversMachinery operators and drivers | count | Number of people in the postcode who lodged a tax return with occupation group 'machinery operators and drivers' for the year. |
occ_labourersLabourers | count | Number of people in the postcode who lodged a tax return with occupation group 'labourers' for the year. |
occ_apprentices_traineesApprentices and trainees | count | Number of people in the postcode who lodged a tax return with occupation group 'apprentices and trainees' for the year. |