Sign in
latestOpenAPI 3.0.02026-08-0811452.3 KB

d8c8699063a9

US Current and Historical Data

US historic values for a date

All COVID data for the US on a specific date.

get/v1/us/{date}.{format}

Path parameters

formatstring required
Example:json

Use 'json' to return JSON arrays or object. Use 'csv' to return a CSV file.

datestring required
Example:20200501

Use the ISO-formatted date, without hyphens, to select just the data for a specific date.

Response

OK

dateinteger

Date on which data was collected by The COVID Tracking Project.

statesinteger

Number of states and territories included in the US dataset for this day.

positiveinteger nullable

Individuals with confirmed or probable COVID-19 per the expanded CSTE case definition of April 5th, 2020 approved by the CDC.

negativeinteger nullable

Individuals with a completed viral test that returned a negative result. For states / territories that do not report this number directly, we compute it using one of several methods, depending on which data points the state provides.

pendinginteger nullable

Tests whose results have not yet been reported.

hospitalizedCurrentlyinteger nullable

Individuals who are currently hospitalized with COVID-19. Definitions vary by state / territory. Where possible, we report hospitalizations with confirmed or probable COVID-19 cases per the expanded CSTE case definition of April 5th, 2020 approved by the CDC.

hospitalizedCumulativeinteger nullable

Total number of individuals who have ever been hospitalized with COVID-19. Definitions vary by state / territory. Where possible, we report hospitalizations with confirmed or probable COVID-19 cases per the expanded CSTE case definition of April 5th, 2020 approved by the CDC.

inIcuCurrentlyinteger nullable

Individuals who are currently hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory. Where possible, we report patients in the ICU with confirmed or probable COVID-19 cases per the expanded CSTE case definition of April 5th, 2020 approved by the CDC.

inIcuCumulativeinteger nullable

Total number of individuals who have ever been hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory. Where possible, we report patients in the ICU with confirmed or probable COVID-19 cases per the expanded CSTE case definition of April 5th, 2020 approved by the CDC.

onVentilatorCurrentlyinteger nullable

Individuals who are currently hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory. Where possible, we report patients on ventilation with confirmed or probable COVID-19 cases per the expanded CSTE case definition of April 5th, 2020 approved by the CDC.

onVentilatorCumulativeinteger nullable

Total number of individuals who have ever been hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory. Where possible, we report patients on ventilation with confirmed or probable COVID-19 cases per the expanded CSTE case definition of April 5th, 2020 approved by the CDC.

recoveredinteger nullable

Deprecated: Individuals who have recovered from COVID-19. Definitions vary by state / territory.

dateCheckedstring nullable

Deprecated. This is an old label for lastUpdateEt.

deathinteger nullable

Total fatalities with confirmed OR probable COVID-19 case diagnosis (per the expanded CSTE case definition of April 5th, 2020 approved by the CDC). In states where the information is available, it only tracks fatalities with confirmed OR probable COVID-19 case diagnosis where COVID-19 is an underlying cause of death according to the death certificate based on WHO guidelines.

hospitalizedinteger nullable

Deprecated. Old label for hospitalizedCumulative.

totalinteger nullable

Deprecated. Computed by adding positive, negative, and pending values.

totalTestResultsinteger nullable

Where possible, we report total tests in units of people tested, rather than units of specimens tested. Currently computed by adding positive and negative values because some states do not report totals and to work around different reporting cadences for cases and tests.

posNeginteger nullable

Deprecated. Computed by adding positive and negative values.

deathIncreaseinteger nullable

Increase in death computed by subtracting the value of death for the previous day from the value of death for the current day.

hospitalizedIncreaseinteger nullable

Increase in hospitalizedCumulative computed by subtracting the value of hospitalizedCumulative for the previous day from the value of hospitalizedCumulative for the current day.

negativeIncreaseinteger nullable

Increase in negative computed by subtracting the value of negative for the previous day from the value for negative from the current day.

positiveIncreaseinteger nullable

Increase in positive computed by subtracting the value of positive from the previous day from the value of positive for the current day.

totalTestResultsIncreaseinteger nullable

Deprecated. Increase in totalTestResults computed by subtracting the value of totalTestResults for the previous day from the value of totalTestResults for the current day.

lastModifiedstring

Deprecated. Old label for lastUpdateET.

hashstring

A hash for this record

Example response

[
  {
    "date": 20200501,
    "states": 50,
    "positive": 50,
    "negative": 50,
    "pending": 50,
    "hospitalizedCurrently": 50,
    "hospitalizedCumulative": 50,
    "inIcuCurrently": 50,
    "inIcuCumulative": 50,
    "onVentilatorCurrently": 50,
    "onVentilatorCumulative": 50,
    "recovered": 50,
    "death": 50,
    "hospitalized": 50,
    "total": 50,
    "totalTestResults": 50,
    "posNeg": 50,
    "deathIncrease": 50,
    "hospitalizedIncrease": 50,
    "negativeIncrease": 50,
    "positiveIncrease": 50,
    "totalTestResultsIncrease": 50,
    "lastModified": "2020-05-27T12:18:23.392Z"
  }
]