Provides an interface to source specific classes which support regional level data. For simple use cases this allows downloading clean, standardised, regional-level COVID-19 data sets. Internally this uses the DataClass() parent class which allows documented downloading, cleaning, and processing. Optionally all steps of data processing can be returned along with the functions used for processing but by default just the finalised processed data is returned. See the examples for some potential use cases and the links to lower level functions for more details and options.

  level = "1",
  totals = FALSE,
  localise = TRUE,
  steps = FALSE,
  class = FALSE,
  verbose = TRUE,
  include_level_2_regions = deprecated(),
  localise_regions = deprecated(),



A character string specifying the country to get data from. Not case dependent. Name should be the English name. For a list of options use get_available_datasets().


A character string indicating the target administrative level of the data with the default being "1". Currently supported options are level 1 ("1) and level 2 ("2"). Use get_available_datasets() for supported options by dataset.


Logical, defaults to FALSE. If TRUE, returns totalled data per region up to today's date. If FALSE, returns the full dataset stratified by date and region.


Logical, defaults to TRUE. Should region names be localised.


Logical, defaults to FALSE. Should all processing and cleaning steps be kept and output in a list.


Logical, defaults to FALSE. If TRUE returns the DataClass object rather than a tibble or a list of tibbles. Overrides steps.


Logical, defaults to TRUE. Should verbose processing messages and warnings be returned.


A character vector of target regions to be assigned to the target_regions field and used to filter the returned data.


[Deprecated] Boolean. If TRUE, returns data stratified by level 2 regions. If FALSE, stratified by Level 1. Note that Level 2 region data is not always available. In these cases the user will get a warning and the Level 1 data will be returned.


[Deprecated] Logical, defaults to TRUE. Should region names be localised.


Additional arguments to pass to class specific functionality.


A tibble with data related to cases, deaths, hospitalisations, recoveries and testing stratified by regions within the given country.

See also


if (FALSE) {
# set up a data cache

# download data for Italy

# return totals for Italy with no localisation
get_regional_data("italy", localise = FALSE, totals = TRUE)

# download data for the UK but return the class
uk <- get_regional_data("United Kingdom", class = TRUE)

# return UK data from the class object]