% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/individuals.R
\name{ato_individuals}
\alias{ato_individuals}
\title{Individual Taxation Statistics snapshot}
\source{
Australian Taxation Office Taxation Statistics
\url{https://www.ato.gov.au/about-ato/research-and-statistics/}.
Licensed CC BY 2.5 AU.
}
\usage{
ato_individuals(year = "latest")
}
\arguments{
\item{year}{Year in \code{"YYYY-YY"} form (e.g. \code{"2022-23"}) or
\code{"latest"}. \code{"latest"} resolves to the most recently
published release (currently 2022-23).}
}
\value{
An \code{ato_tbl} with one row per aggregate line-item and
columns for count and amount in nominal AUD.
}
\description{
Returns the Individuals Table 1 snapshot: aggregate counts,
total income, taxable income, tax payable, and deductions
across all individual returns (roughly 14 million per year).
The snapshot is the headline table; for finer cuts use the
dedicated functions:
\itemize{
\item \code{\link[=ato_individuals_postcode]{ato_individuals_postcode()}} for geographic breakdowns,
\item \code{\link[=ato_individuals_occupation]{ato_individuals_occupation()}} for occupation × sex × income-range
detail, or
\item \code{\link[=ato_download]{ato_download()}} with a custom \code{pattern} for specific
Tables 2 to 27 (age, sex, state, industry, source of income,
deductions, offsets, CGT, non-residents).
}
}
\details{
Monetary values are nominal AUD of the reporting year. Use
\code{inflateR::inflate()} or the ABS CPI series if you need
real-term comparisons.
}
\examples{
\donttest{
op <- options(ato.cache_dir = tempdir())
try({
  ind <- ato_individuals(year = "2022-23")
  head(ind)
})
options(op)
}
}
\seealso{
Other individuals: 
\code{\link{ato_individuals_age}()},
\code{\link{ato_individuals_occupation}()},
\code{\link{ato_individuals_postcode}()},
\code{\link{ato_individuals_sex}()},
\code{\link{ato_individuals_state}()}
}
\concept{individuals}
