The CDC FluView Portal provides in-season and past seasons' national, regional, and state-level outpatient illness and viral surveillance data from both ILINet (Influenza-like Illness Surveillance Network) and WHO/NREVSS (National Respiratory and Enteric Virus Surveillance System).

who_nrevss(region = c("national", "hhs", "census", "state"), years = NULL)



one of "national", "hhs", "census", or "state"


a vector of years to retrieve data for (i.e. 2014 for CDC flu season 2014-2015). CDC has data for this API going back to 1997. Default value (NULL) means retrieve all years. NOTE: if you happen to specify a 2-digit season value (i.e. 57 == 2017-2018) the function is smart enough to retrieve by season ID vs convert that to a year.


list of data frames identified by

  • combined_prior_to_2015_16

  • public_health_labs

  • clinical_labs


This function retrieves current and historical WHO/NREVSS surveillance data for the identified region.


HHS, Census and State data retrieval is not as "instantaneous" as their ILINet counterparts.

Also, beginning for the 2015-16 season, reports from public health and clinical laboratories are presented separately in the weekly influenza update. This is the reason why a list of data frames is returned.

ALSO The new CDC API seems to be missing some public health lab data fields.



if (FALSE) {
national_who <- who_nrevss("national")
hhs_who <- who_nrevss("hhs")
census_who <- who_nrevss("census")
state_who <- who_nrevss("state")