pub_covid_hosp_state_timeseries: COVID hospitalizations by state

In epidatr: Client for Delphi's 'Epidata' API

COVID hospitalizations by state

Description

API docs: https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp.html.

Obtains the COVID-19 reported patient impact and hospital capacity data by state. This dataset is provided by the US Department of Health & Human Services.

Usage

pub_covid_hosp_state_timeseries(
  states,
  dates = "*",
  ...,
  as_of = NULL,
  issues = NULL,
  fetch_args = fetch_args_list()
)

Arguments

states	character. Two-letter state abbreviations. See US states codes for details.
dates	timeset. Dates to fetch. Supports epirange() and defaults to all ("*") dates.
...	not used for values, forces later arguments to bind by name
as_of	Date. Optionally, the as-of date for the issues to fetch. See the "Data Versioning" section for details.
issues	timeset. Optionally, the issue(s) of the data to fetch. See the "Data Versioning" section for details.
fetch_args	fetch_args_list(). Additional arguments to pass to fetch(). See fetch_args_list() for details.

Details

Starting October 1, 2022, some facilities are only required to report annually.

Value

tibble::tibble

Data Versioning

Several endpoints support retrieving historical versions of the data. The following parameters control this and are mutually exclusive (only one can be provided at a time).

• as_of: (Date) Retrieve the data as it was on this date.

• issues: timeset Retrieve data from a specific issue date or range of dates.

• lag: (integer) Retrieve data with a specific lag from its issue date.

If none of these is specified, the most recent version of the data is returned.

See vignette("versioned-data") for details and more ways to specify versioned data.

See also

For example queries showing how to discover signals and build calls, see vignette("signal-discovery", package = "epidatr").

Examples

pub_covid_hosp_state_timeseries(
  states = "fl",
  dates = epirange(20200101, 20200501)
)

epidatr documentation built on June 3, 2026, 1:06 a.m.