Returns the annual Company Taxation Statistics tables. The Company release ships tables covering entity type, turnover band, industry, taxable status, source of income, and expense deductions. Pick the table that matches your question:
Usage
ato_companies(
year = "latest",
table = c("industry", "snapshot", "key_items_by_size", "entity_type",
"industry_by_size", "sub_industry", "taxable_status", "source", "expenses"),
industry = NULL
)Arguments
- year
"YYYY-YY","latest", or a vector of years for a multi-year panel. Multi-year requests add ayearcolumn.- table
One of
"snapshot","key_items_by_size","entity_type","industry"(default),"industry_by_size","sub_industry","taxable_status","source", or"expenses".- industry
Optional substring filter on industry name (applied only when the fetched table has an industry column).
Details
snapshot (T1): aggregate counts, total income, net tax across all companies (~1m entities)
key_items_by_size (T2): net tax by company size band
entity_type (T3): split by public/private/co-operative
industry (T4, default): key items by 2-digit ANZSIC subdivision
industry_by_size (T5): industry x turnover band
sub_industry (T6): 4-digit ANZSIC class detail
taxable_status (T7): items by taxable status
source (T8): source of income
expenses (T9): expense and deduction categories
Classification break. Releases from 2022-23 onwards use ANZSIC 2020; earlier releases use ANZSIC 2006. A warning is emitted when the requested year(s) are at or after this boundary, or when a multi-year request spans it.
References
Australian Taxation Office (annual). Taxation Statistics: Company tables explanatory notes. Methodology notes on lodgement cut-off, entity-type definitions, and turnover-band thresholds. Accessible from https://www.ato.gov.au/about-ato/research-and-statistics/in-detail/taxation-statistics/.
Australian Bureau of Statistics (2020). Australian and New Zealand Standard Industrial Classification (ANZSIC), 2006 revision with 2020 update. Catalogue 1292.0.
Examples
# \donttest{
op <- options(ato.cache_dir = tempdir())
try({
s <- ato_companies(year = "2022-23", table = "snapshot")
head(s)
m <- ato_companies(year = "2022-23", industry = "mining")
head(m)
# Multi-year industry panel
panel <- ato_companies(year = c("2021-22", "2022-23"))
})
#> ℹ Downloading <https://data.gov.au/data/dataset/03326c3f-c0d3-4af4-afc7-c6ccc0a…
#> ✔ Downloading <https://data.gov.au/data/dataset/03326c3f-c0d3-4af4-afc7-c6ccc0a…
#>
#> Warning: Could not find "industry" column. Tried: "industry", "industry_description",
#> "broad_industry", and "anzsic_industry".
#> Warning: 2022-23 uses ANZSIC 2020 industry codes.
#> ℹ Releases before 2022-23 use ANZSIC 2006.
#> ℹ Cross-year industry joins need a concordance recode.
#> ℹ Downloading <https://data.gov.au/data/dataset/03326c3f-c0d3-4af4-afc7-c6ccc0a…
#> ✔ Downloading <https://data.gov.au/data/dataset/03326c3f-c0d3-4af4-afc7-c6ccc0a…
#>
#> Warning: Could not find "industry" column. Tried: "industry", "industry_description",
#> "broad_industry", and "anzsic_industry".
#> Warning: Requested years span the ANZSIC 2006 → 2020 (industry) reclassification in
#> 2022-23.
#> ℹ Cross-year comparisons across this boundary need a concordance recode.
#> ℹ Downloading <https://data.gov.au/data/dataset/4be150cc-8f84-46b8-8c61-55ff1d4…
#> ✔ Downloading <https://data.gov.au/data/dataset/4be150cc-8f84-46b8-8c61-55ff1d4…
#>
#> Warning: Could not find "industry" column. Tried: "industry", "industry_description",
#> "broad_industry", and "anzsic_industry".
#> Warning: 2022-23 uses ANZSIC 2020 industry codes.
#> ℹ Releases before 2022-23 use ANZSIC 2006.
#> ℹ Cross-year industry joins need a concordance recode.
#> Warning: Could not find "industry" column. Tried: "industry", "industry_description",
#> "broad_industry", and "anzsic_industry".
options(op)
# }