latestOpenAPI 3.0.02026-08-0811452.3 KB

d8c8699063a9

States Current and Historical Data

Historic values for all states

Lists all COVID data available for every state since tracking started.

get/v1/states/daily.{format}

Path parameters

formatstring required
Example:json

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

Response

OK

dateinteger

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

statestring

Two-letter abbreviation for the state or territory.

fipsstring nullable

Federal Information Processing Standards (FIPS) code for the state or territory.

positiveinteger nullable

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

probableCasesinteger nullable

Probable cases

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.

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.

negativeIncreaseinteger nullable

Deprecated

pendinginteger nullable

Tests whose results have not yet been reported.

totalinteger nullable

Deprecated

totalTestResultsSourcestring nullable

Indicates which field is being used for total test results. If it is posNeg, then it is calculated by adding all positive and negative 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.

totalTestResultsIncreaseinteger nullable

Daily Difference in totalTestResults

posNeginteger nullable

Deprecated

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

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

dataQualityGradestring nullable

The COVID Tracking Project grade of the completeness of the data reporting by a state.

lastUpdateEtstring nullable

Date and time in Eastern time the state or territory last updated the data.

dateModifiedstring nullable

Deprecated, use lastUpdateEt instead

checkTimeEtstring nullable

Deprecated

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.

deathIncreaseinteger nullable

Daily difference in death

hospitalizedinteger nullable

Deprecated

hospitalizedDischargedinteger nullable

Total number of discharged hospitalizations

hospitalizedIncreaseinteger nullable

Daily difference in hospitalized

dateCheckedstring nullable

Deprecated

hashstring nullable

Deprecated - A hash of the current record.

commercialScoreinteger nullable

Deprecated

negativeRegularScoreinteger nullable

Deprecated

negativeScoreinteger nullable

Deprecated

positiveScoreinteger nullable

Deprecated

scoreinteger nullable

Deprecated

gradestring nullable

Deprecated

totalTestsViralinteger nullable

Completed viral tests.

positiveTestsViralinteger nullable

Completed viral tests that returned positive results.

negativeTestsViralinteger nullable

Completed viral tests that returned negative results.

positiveCasesViralinteger nullable

Individuals with a completed viral test that returned a positive result.

deathConfirmedinteger nullable

Total fatalities with confirmed 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 COVID-19 case diagnosis where COVID-19 is an underlying cause of death according to the death certificate based on WHO guidelines.

deathProbableinteger nullable

Total fatalities with 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 probable COVID-19 case diagnosis where COVID-19 is an underlying cause of death according to the death certificate based on WHO guidelines.

totalTestEncountersViralinteger nullable
totalTestsPeopleViralinteger nullable
totalTestsAntibodyinteger nullable
positiveTestsAntibodyinteger nullable
negativeTestsAntibodyinteger nullable
totalTestsPeopleAntibodyinteger nullable
positiveTestsPeopleAntibodyinteger nullable
negativeTestsPeopleAntibodyinteger nullable
totalTestsPeopleAntigeninteger nullable
positiveTestsPeopleAntigeninteger nullable
totalTestsAntigeninteger nullable
positiveTestsAntigeninteger nullable

Example response

[
  {
    "date": 20200501,
    "totalTestResultsSource": "posNeg"
  }
]