% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/individuals.R
\name{ato_individuals_occupation}
\alias{ato_individuals_occupation}
\title{Individual tax data by occupation}
\source{
Australian Taxation Office Taxation Statistics.
Licensed CC BY 2.5 AU.
}
\usage{
ato_individuals_occupation(
  year = "latest",
  occupation = NULL,
  sex = c("all", "male", "female", "m", "f")
)
}
\arguments{
\item{year}{\code{"YYYY-YY"}, \code{"latest"}, or a vector of years for
a multi-year panel (e.g. \code{c("2020-21", "2021-22", "2022-23")}).}

\item{occupation}{Optional substring filter (case-insensitive)
applied to the occupation description column.}

\item{sex}{One of \code{"all"} (default), \code{"male"}, or \code{"female"}.
Rows with sex recorded as \code{"Not stated"} are dropped when
filtering to male or female. Short forms \code{"m"}/\code{"f"} are
accepted.}
}
\value{
An \code{ato_tbl} with one row per occupation-sex-income
combination. Multi-year queries add a \code{year} column.
Monetary values in nominal AUD of the reporting year.
}
\description{
Returns the Individuals Table 14 (occupation by sex by taxable
income range). Around 1,000 occupations classified by ANZSCO
with aggregate counts, total income, taxable income, and tax
payable. The ATO migrated from ANZSCO 2013 to ANZSCO 2021
across the 2022-23 release; cross-year joins on occupation
name or code must account for the recode.
}
\details{
\strong{Classification break.} Releases from 2022-23 onwards use
ANZSCO 2021; earlier releases use ANZSCO 2013. A warning is
emitted when the requested year(s) are at or after this boundary,
or when a multi-year request spans it.
}
\examples{
\donttest{
op <- options(ato.cache_dir = tempdir())
try({
  occ <- ato_individuals_occupation(year = "2022-23",
                                    occupation = "economist")
  head(occ)
  # Multi-year panel
  panel <- ato_individuals_occupation(year = c("2021-22", "2022-23"),
                                      occupation = "nurse")
})
options(op)
}
}
\seealso{
Other individuals: 
\code{\link{ato_individuals}()},
\code{\link{ato_individuals_age}()},
\code{\link{ato_individuals_postcode}()},
\code{\link{ato_individuals_sex}()},
\code{\link{ato_individuals_state}()}
}
\concept{individuals}
