--- title: "US historic values for a date" method: GET path: "/v1/us/{date}.{format}" tags: ["US Current and Historical Data"] --- # US historic values for a date `GET /v1/us/{date}.{format}` All COVID data for the US on a specific date. ## Path parameters - `format` string, required - `date` string, required ## Response `200` OK - Us[] - `date` integer — Date on which data was collected by The COVID Tracking Project. - `states` integer — Number of states and territories included in the US dataset for this day. - `positive` integer, nullable — Individuals with confirmed or probable COVID-19 per the expanded [CSTE case definition](https://cdn.ymaws.com/www.cste.org/resource/resmgr/2020ps/Interim-20-ID-01_COVID-19.pdf) of April 5th, 2020 [approved by the CDC](https://wwwn.cdc.gov/nndss/conditions/coronavirus-disease-2019-covid-19/case-definition/2020/). - `negative` integer, 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. - `pending` integer, nullable — Tests whose results have not yet been reported. - `hospitalizedCurrently` integer, 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](https://cdn.ymaws.com/www.cste.org/resource/resmgr/2020ps/Interim-20-ID-01_COVID-19.pdf) of April 5th, 2020 [approved by the CDC](https://wwwn.cdc.gov/nndss/conditions/coronavirus-disease-2019-covid-19/case-definition/2020/). - `hospitalizedCumulative` integer, 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](https://cdn.ymaws.com/www.cste.org/resource/resmgr/2020ps/Interim-20-ID-01_COVID-19.pdf) of April 5th, 2020 [approved by the CDC](https://wwwn.cdc.gov/nndss/conditions/coronavirus-disease-2019-covid-19/case-definition/2020/). - `inIcuCurrently` integer, 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](https://cdn.ymaws.com/www.cste.org/resource/resmgr/2020ps/Interim-20-ID-01_COVID-19.pdf) of April 5th, 2020 [approved by the CDC](https://wwwn.cdc.gov/nndss/conditions/coronavirus-disease-2019-covid-19/case-definition/2020/). - `inIcuCumulative` integer, 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](https://cdn.ymaws.com/www.cste.org/resource/resmgr/2020ps/Interim-20-ID-01_COVID-19.pdf) of April 5th, 2020 [approved by the CDC](https://wwwn.cdc.gov/nndss/conditions/coronavirus-disease-2019-covid-19/case-definition/2020/). - `onVentilatorCurrently` integer, 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](https://cdn.ymaws.com/www.cste.org/resource/resmgr/2020ps/Interim-20-ID-01_COVID-19.pdf) of April 5th, 2020 [approved by the CDC](https://wwwn.cdc.gov/nndss/conditions/coronavirus-disease-2019-covid-19/case-definition/2020/). - `onVentilatorCumulative` integer, 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](https://cdn.ymaws.com/www.cste.org/resource/resmgr/2020ps/Interim-20-ID-01_COVID-19.pdf) of April 5th, 2020 [approved by the CDC](https://wwwn.cdc.gov/nndss/conditions/coronavirus-disease-2019-covid-19/case-definition/2020/). - `recovered` integer, nullable — Deprecated: Individuals who have recovered from COVID-19. Definitions vary by state / territory. - `dateChecked` string, nullable — Deprecated. This is an old label for *lastUpdateEt*. - `death` integer, nullable — Total fatalities with confirmed OR probable COVID-19 case diagnosis (per the expanded [CSTE case definition](https://cdn.ymaws.com/www.cste.org/resource/resmgr/2020ps/Interim-20-ID-01_COVID-19.pdf) of April 5th, 2020 [approved by the CDC](https://wwwn.cdc.gov/nndss/conditions/coronavirus-disease-2019-covid-19/case-definition/2020/)). 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](https://www.who.int/classifications/icd/Guidelines_Cause_of_Death_COVID-19.pdf?ua=1). - `hospitalized` integer, nullable — Deprecated. Old label for hospitalizedCumulative. - `total` integer, nullable — Deprecated. Computed by adding *positive*, *negative*, and *pending* values. - `totalTestResults` integer, 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. - `posNeg` integer, nullable — Deprecated. Computed by adding *positive* and *negative* values. - `deathIncrease` integer, nullable — Increase in *death* computed by subtracting the value of *death* for the previous day from the value of *death* for the current day. - `hospitalizedIncrease` integer, nullable — Increase in *hospitalizedCumulative* computed by subtracting the value of *hospitalizedCumulative* for the previous day from the value of *hospitalizedCumulative* for the current day. - `negativeIncrease` integer, nullable — Increase in *negative* computed by subtracting the value of *negative* for the previous day from the value for *negative* from the current day. - `positiveIncrease` integer, nullable — Increase in *positive* computed by subtracting the value of *positive* from the previous day from the value of *positive* for the current day. - `totalTestResultsIncrease` integer, 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. - `lastModified` string — Deprecated. Old label for lastUpdateET. - `hash` string — A hash for this record --- [API](https://skmtc.net/covidtracking/apis/covid-tracking-project-api.md) · [All operations](https://skmtc.net/covidtracking/apis/covid-tracking-project-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/covidtracking/covid-tracking-project-api/revisions/d8c8699063a9/schema)