Package: ato 0.1.0

ato: Download and Tidy Australian Taxation Office Data

Fetch Australian Taxation Office (ATO) Taxation Statistics and related datasets via the data.gov.au Comprehensive Knowledge Archive Network ('CKAN') API <https://data.gov.au/data/api/3/>. Provides tidy access to individual, company, superannuation, goods and services tax (GST), fringe benefits tax (FBT), Voluntary Tax Transparency Code (VTTC), Pay As You Go (PAYG) withholding, charity, excise, and Corporate Tax Transparency data, plus Division 293, Petroleum Resource Rent Tax, Medicare Levy Surcharge, fuel tax credits, compliance, and Working Holiday Maker aggregates. Includes reproducibility helpers (snapshot pinning, SHA-256 cache integrity, session manifest, optional 'Zenodo' deposit), classification crosswalks (ANZSIC 2006 to 2020, ANZSCO 2013 to 2021), panel harmonisation, reconciliation against Final Budget Outcome totals, and real-terms and per-capita helpers backed by bundled Australian Bureau of Statistics (ABS) Consumer Price Index and Estimated Resident Population series. Bridges to the 'taxstats' 2 per cent microdata sample via column-schema mapping. Data is published by the Australian Taxation Office under Creative Commons Attribution 2.5 Australia or 3.0 Australia licences (dataset-dependent).

Authors:Charles Coverdale [aut, cre]

ato_0.1.0.tar.gz
ato_0.1.0.zip(r-4.7)ato_0.1.0.zip(r-4.6)ato_0.1.0.zip(r-4.5)
ato_0.1.0.tgz(r-4.6-any)ato_0.1.0.tgz(r-4.5-any)
ato_0.1.0.tar.gz(r-4.7-any)ato_0.1.0.tar.gz(r-4.6-any)
ato_0.1.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
ato/json (API)

# Install 'ato' in R:
install.packages('ato', repos = c('https://charlescoverdale.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/charlescoverdale/ato/issues

Pkgdown/docs site:https://charlescoverdale.github.io

On CRAN:

Conda:

4.88 score 1 scripts 451 downloads 50 exports 27 dependencies

Last updated from:514c4fc156. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-x86_64OK139
source / vignettesOK162
linux-release-x86_64OK127
macos-release-arm64OK102
macos-oldrel-arm64OK83
windows-develOK72
windows-releaseOK85
windows-oldrelOK81
wasm-releaseOK106

Exports:ato_cache_infoato_catalogato_charitiesato_citeato_clear_cacheato_companiesato_complianceato_crosswalkato_deflateato_deposit_zenodoato_division293ato_downloadato_exciseato_fbtato_fuel_tax_creditsato_gstato_harmoniseato_helpato_individualsato_individuals_ageato_individuals_occupationato_individuals_postcodeato_individuals_sexato_individuals_stateato_industryato_internationalato_irpdato_manifestato_manifest_clearato_manifest_writeato_medicare_levyato_metaato_paygato_per_capitaato_prrtato_rbaato_rdtiato_reconcileato_schema_mapato_sha256ato_sme_benchmarksato_snapshotato_state_taxato_super_fundsato_tax_expendituresato_tax_gapsato_to_taxstatsato_top_taxpayersato_vttcato_whm

Dependencies:askpasscellrangerclicpp11crayoncurlgluehmshttr2jsonlitelifecyclemagrittropensslpillarpkgconfigprettyunitsprogressR6rappdirsreadxlrematchrlangsystibbleutf8vctrswithr

Canonical replications: top 1% share, corporate ETR, tax gap trend
1. Top 1 per cent income share (Atkinson-Leigh style) | 2. Corporate effective tax rate by industry (transparency data) | 3. Tax gap trend and confidence context | 4. HELP debt by age cohort
Rendered fromcanonical-replications.Rmdusingknitr::rmarkdown

Last update: 2026-04-24
Started: 2026-04-24

Interop with grattan and taxstats: costing a hypothetical reform
Schema map | Costing a hypothetical reform | Bridge to microdata | Summary
Rendered frominterop-grattan-taxstats.Rmdusingknitr::rmarkdown

Last update: 2026-04-24
Started: 2026-04-24

Reproducibility workflow: snapshot, manifest, SHA-256, Zenodo
Setup | Fetch your datasets | Inspect the session manifest | Export the manifest for your paper appendix | Mint a DOI via Zenodo | Citing a dataset with full provenance
Rendered fromreproducibility.Rmdusingknitr::rmarkdown

Last update: 2026-04-24
Started: 2026-04-24

Methodology: hand-computed worked examples
1. ato_deflate() | Formula | Hand calculation | Sanity: identity at the base year | 2. ato_reconcile() | Warning threshold | 3. ato_per_capita() | 4. ato_sha256() | Specification | Verification | Summary
Rendered frommethodology.Rmdusingknitr::rmarkdown

Last update: 2026-04-24
Started: 2026-04-24

Panels, harmonisation, reconciliation, real terms, per-capita
Build a multi-year panel | Harmonise column names | Reconcile against Commonwealth totals | Real-terms comparison | Per-capita normalisation
Rendered frompanel-and-reconcile.Rmdusingknitr::rmarkdown

Last update: 2026-04-24
Started: 2026-04-24

Readme and manuals

Help Manual

Help pageTopics
Inspect the local ato cacheato_cache_info
ATO dataset catalogueato_catalog
Charity and deductible gift recipient dataato_charities
Cite an ato_tbl (or URL) in BibTeX and plain-text formato_cite
Clear the ato cacheato_clear_cache
Company Taxation Statisticsato_companies
ATO compliance program outcomesato_compliance
Load a bundled ATO crosswalk tableato_crosswalk
Deflate nominal AUD to real AUDato_deflate
Prepare a Zenodo deposit payload for the session manifestato_deposit_zenodo
Division 293 tax assessments (high-income super contributions)ato_division293
Download a resource from an ATO datasetato_download
Excise and fuel tax credit rates and clearancesato_excise
Fringe Benefits Tax statisticsato_fbt
Fuel Tax Credits by industry and claim periodato_fuel_tax_credits
GST and activity statement ratiosato_gst
Harmonise column names in a multi-year ATO panelato_harmonise
Study and Training Support Loan data (HELP, AASL, VSL)ato_help
Individual Taxation Statistics snapshotato_individuals
Individual tax data by age rangeato_individuals_age
Individual tax data by occupationato_individuals_occupation
Individual tax data by postcodeato_individuals_postcode
Individual tax data by sexato_individuals_sex
Individual tax data by state or territoryato_individuals_state
Industry aggregates across entity typesato_industry
OECD Revenue Statistics comparisonato_international
International Related Party Dealings (IRPD)ato_irpd
Return the session manifest of fetched ATO datasetsato_manifest
Clear the session manifestato_manifest_clear
Write the session manifest to a fileato_manifest_write
Medicare Levy and Medicare Levy Surchargeato_medicare_levy
Fetch CKAN metadata for an ATO datasetato_meta
PAYG withholding dataato_payg
Express an aggregate per capita using ABS ERPato_per_capita
Petroleum Resource Rent Tax (PRRT) annual dataato_prrt
RBA Commonwealth receipts (H1 statistical table)ato_rba
R&D Tax Incentive claimantsato_rdti
Reconcile an aggregate against Commonwealth budget totalsato_reconcile
Print the ATO -> taxstats schema mapato_schema_map
Compute the SHA-256 digest of a fileato_sha256
Small Business Benchmarksato_sme_benchmarks
Pin or inspect the session snapshot dateato_snapshot
State and territory tax revenue (ABS 5506.0)ato_state_tax
Superannuation fund aggregatesato_super_funds
Tax Expenditures and Insights Statement (TEIS)ato_tax_expenditures
Australian tax gaps estimatesato_tax_gaps
Remap an ato_tbl to the taxstats microdata column schemaato_to_taxstats
Corporate Tax Transparencyato_top_taxpayers
Voluntary Tax Transparency Code disclosuresato_vttc
Working Holiday Maker tax dataato_whm
Print an ato_tblprint.ato_tbl