Data API

Latest changes

Notice: The COVID Tracking Project has ended all data collection as of March 7, 2021. The existing API will continue to work until May 2021, but will only include data up to March 7, 2021.

Our public data API provides access to all of our data at a national and state level. We provide data in both JSON and CSV format. You can also download CSV data directly.

Version 2 of our API is available.

Our data is provided under our project-wide data license.
Fields may over time be marked as deprecated. These fields may remain static or change to null values after a period of two weeks.
New fields may be added without warning, but will not alter the structure of the data. If you are using CSV files, make sure to use the column names from the file to lookup data, not the column numbers, which can change.
All URLs in our API, including state codes, should be in lower-case.
We do not support cross-domain requests using CORS.

API domain name

All API requests should be made to: https://api.covidtracking.com

US Current and Historical Data

All COVID data for the US.

View data source for Historic US values

JSON format

/v1/us/daily.json

Example: https://api.covidtracking.com/v1/us/daily.json

CSV format

/v1/us/daily.csv

Example: https://api.covidtracking.com/v1/us/daily.csv

Fields

date: Field type: integer
Date
Date on which data was collected by The COVID Tracking Project.
dateChecked: Field type: string
Deprecated. This is an old label for lastUpdateEt.
death: Field type: integer
Deaths (confirmed and probable)
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 some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for fatalities, the metric includes only deaths with COVID-19 listed on the death certificate, unless deaths among cases is a more reliable metric in the state.
Returns null if no data is available
deathIncrease: Field type: integer
New deaths
Daily increase in death, calculated from the previous day’s value.
Returns null if no data is available
hash: Field type: string
A hash for this record
hospitalized: Field type: integer
Deprecated. Old label for hospitalizedCumulative.

Returns null if no data is available
hospitalizedCumulative: Field type: integer
Cumulative hospitalized/Ever hospitalized
Total number of individuals who have ever been hospitalized with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients hospitalized with confirmed or suspected COVID-19 cases.
Returns null if no data is available
hospitalizedCurrently: Field type: integer
Currently hospitalized/Now hospitalized
Individuals who are currently hospitalized with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients hospitalized with confirmed or suspected COVID-19 cases.
Returns null if no data is available
hospitalizedIncrease: Field type: integer
New total hospitalizations
Daily increase in hospitalizedCumulative, calculated from the previous day’s value.
Returns null if no data is available
inIcuCumulative: Field type: integer
Cumulative in ICU/Ever in ICU
Total number of individuals who have ever been hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients in the ICU with confirmed or suspected COVID-19 cases.
Returns null if no data is available
inIcuCurrently: Field type: integer
Currently in ICU/Now in ICU
Individuals who are currently hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients in the ICU with confirmed or suspected COVID-19 cases.
Returns null if no data is available
lastModified: Field type: string
Deprecated. Old label for lastUpdateET.
negative: Field type: integer
Negative PCR tests (people)
Total number of unique people with a completed PCR test that returns negative. 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. Due to complex reporting procedures, this number might be mixing units and therefore, at best, it should only be considered an estimate of the number of people with a completed PCR test that return negative.
Returns null if no data is available
negativeIncrease: Field type: integer
Increase in negative computed by subtracting the value of negative for the previous day from the value for negative from the current day.

Returns null if no data is available
onVentilatorCumulative: Field type: integer
Cumulative on ventilator/Ever on ventilator
Total number of individuals who have ever been hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients on ventilation with confirmed or suspected COVID-19 cases.
Returns null if no data is available
onVentilatorCurrently: Field type: integer
Currently on ventilator/Now on ventilator
Individuals who are currently hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients on ventilation with confirmed or suspected COVID-19 cases.
Returns null if no data is available
pending: Field type: integer
Pending
Total number of viral tests that have not been completed as reported by the state or territory.
Returns null if no data is available
posNeg: Field type: integer
Deprecated. Computed by adding positive and negative values.

Returns null if no data is available
positive: Field type: integer
Cases (confirmed plus probable)
Total number of confirmed plus probable cases of COVID-19 reported by the state or territory, ideally per the August 5, 2020 CSTE case definition. Some states are following the older April 5th, 2020 CSTE case definition or using their own custom definitions. Not all states and territories report probable cases. If a state is not reporting probable cases, this field will just represent confirmed cases.
Returns null if no data is available
positiveIncrease: Field type: integer
New cases
The daily increase in API field positive, which measures Cases (confirmed plus probable) calculated based on the previous day’s value.
Returns null if no data is available
recovered: Field type: integer
Recovered
Total number of people that are identified as recovered from COVID-19. States provide very disparate definitions on what constitutes a “recovered” COVID-19 case. Types of “recovered” cases include those who are discharged from hospitals, released from isolation after meeting CDC guidance on symptoms cessation, or those who have not been identified as fatalities after a number of days (30 or more) post disease onset. Specifics vary for each state or territory.
Returns null if no data is available
states: Field type: integer
States
Only available in national records. The number of states and territories included in the US dataset for this day.
total: Field type: integer
Deprecated. Computed by adding positive, negative, and pending values.

Returns null if no data is available
totalTestResults: Field type: integer
Total test results
At the national level, this metric is a summary statistic which, because of the variation in test reporting methods, is at best an estimate of US viral (PCR) testing. Some states/territories report tests in units of test encounters, some report tests in units of specimens, and some report tests in units of unique people. Moreover, some jurisdictions include antigen tests in their total test counts without reporting a separate total of viral (PCR) tests. Therefore, this value is an aggregate calculation of heterogeneous figures. Please consult each state or territory’s individual data page to see whether that jurisdiction lumps antigen and PCR tests together and to see what units that jurisdiction uses for test reporting.

In most states, the totalTestResults field is currently computed by adding positive and negative values because, historically, some states do not report totals, and to work around different reporting cadences for cases and tests. In Colorado, Delaware, the District of Columbia, Florida, Hawaii, Minnesota, Nevada, New York, North Dakota, Pennsylvania, Rhode Island, Virginia, Washington, and Wisconsin, where reliable testing encounters figures are available with a complete time series, we directly report those figures in this field. In Alaska, America Samoa, Arizona, Arkansas, California, Connecticut, Georgia, Illinois, Indiana, Kentucky, Maine, Maryland, Massachusetts, Michigan, Missouri, Montana, Nebraska, New Hampshire, New Mexico, North Carolina, Ohio, Oregon, South Dakota, Tennessee, Texas, Utah, Vermont, West Virginia, and Wyoming, where reliable specimens figures are available with a complete time series, we directly report those figures in this field. In Alabama and Idaho where reliable unique people figures are available with a complete time series, we directly report those figures in this field. We are in the process of switching all states over to use directly reported total figures, using a policy of preferring testing encounters, specimens, and people, in that order.
Returns null if no data is available
totalTestResultsIncrease: Field type: integer
New tests
Daily increase in totalTestResults, calculated from the previous day’s value. This calculation includes all the caveats associated with Total tests/totalTestResults, and we recommend against using it at the state/territory level.
Returns null if no data is available

The most recent COVID data for the US. The most recent data may not be from today.

View data source for Current US values

JSON format

/v1/us/current.json

Example: https://api.covidtracking.com/v1/us/current.json

CSV format

/v1/us/current.csv

Example: https://api.covidtracking.com/v1/us/current.csv

Fields

date: Field type: integer
Date
Date on which data was collected by The COVID Tracking Project.
dateChecked: Field type: string
Deprecated. This is an old label for lastUpdateEt.
death: Field type: integer
Deaths (confirmed and probable)
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 some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for fatalities, the metric includes only deaths with COVID-19 listed on the death certificate, unless deaths among cases is a more reliable metric in the state.
Returns null if no data is available
deathIncrease: Field type: integer
New deaths
Daily increase in death, calculated from the previous day’s value.
Returns null if no data is available
hash: Field type: string
A hash for this record
hospitalized: Field type: integer
Deprecated. Old label for hospitalizedCumulative.

Returns null if no data is available
hospitalizedCumulative: Field type: integer
Cumulative hospitalized/Ever hospitalized
Total number of individuals who have ever been hospitalized with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients hospitalized with confirmed or suspected COVID-19 cases.
Returns null if no data is available
hospitalizedCurrently: Field type: integer
Currently hospitalized/Now hospitalized
Individuals who are currently hospitalized with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients hospitalized with confirmed or suspected COVID-19 cases.
Returns null if no data is available
hospitalizedIncrease: Field type: integer
New total hospitalizations
Daily increase in hospitalizedCumulative, calculated from the previous day’s value.
Returns null if no data is available
inIcuCumulative: Field type: integer
Cumulative in ICU/Ever in ICU
Total number of individuals who have ever been hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients in the ICU with confirmed or suspected COVID-19 cases.
Returns null if no data is available
inIcuCurrently: Field type: integer
Currently in ICU/Now in ICU
Individuals who are currently hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients in the ICU with confirmed or suspected COVID-19 cases.
Returns null if no data is available
lastModified: Field type: string
Deprecated. Old label for lastUpdateET.
negative: Field type: integer
Negative PCR tests (people)
Total number of unique people with a completed PCR test that returns negative. 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. Due to complex reporting procedures, this number might be mixing units and therefore, at best, it should only be considered an estimate of the number of people with a completed PCR test that return negative.
Returns null if no data is available
negativeIncrease: Field type: integer
Increase in negative computed by subtracting the value of negative for the previous day from the value for negative from the current day.

Returns null if no data is available
onVentilatorCumulative: Field type: integer
Cumulative on ventilator/Ever on ventilator
Total number of individuals who have ever been hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients on ventilation with confirmed or suspected COVID-19 cases.
Returns null if no data is available
onVentilatorCurrently: Field type: integer
Currently on ventilator/Now on ventilator
Individuals who are currently hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients on ventilation with confirmed or suspected COVID-19 cases.
Returns null if no data is available
pending: Field type: integer
Pending
Total number of viral tests that have not been completed as reported by the state or territory.
Returns null if no data is available
posNeg: Field type: integer
Deprecated. Computed by adding positive and negative values.

Returns null if no data is available
positive: Field type: integer
Cases (confirmed plus probable)
Total number of confirmed plus probable cases of COVID-19 reported by the state or territory, ideally per the August 5, 2020 CSTE case definition. Some states are following the older April 5th, 2020 CSTE case definition or using their own custom definitions. Not all states and territories report probable cases. If a state is not reporting probable cases, this field will just represent confirmed cases.
Returns null if no data is available
positiveIncrease: Field type: integer
New cases
The daily increase in API field positive, which measures Cases (confirmed plus probable) calculated based on the previous day’s value.
Returns null if no data is available
recovered: Field type: integer
Recovered
Total number of people that are identified as recovered from COVID-19. States provide very disparate definitions on what constitutes a “recovered” COVID-19 case. Types of “recovered” cases include those who are discharged from hospitals, released from isolation after meeting CDC guidance on symptoms cessation, or those who have not been identified as fatalities after a number of days (30 or more) post disease onset. Specifics vary for each state or territory.
Returns null if no data is available
states: Field type: integer
States
Only available in national records. The number of states and territories included in the US dataset for this day.
total: Field type: integer
Deprecated. Computed by adding positive, negative, and pending values.

Returns null if no data is available
totalTestResults: Field type: integer
Total test results
At the national level, this metric is a summary statistic which, because of the variation in test reporting methods, is at best an estimate of US viral (PCR) testing. Some states/territories report tests in units of test encounters, some report tests in units of specimens, and some report tests in units of unique people. Moreover, some jurisdictions include antigen tests in their total test counts without reporting a separate total of viral (PCR) tests. Therefore, this value is an aggregate calculation of heterogeneous figures. Please consult each state or territory’s individual data page to see whether that jurisdiction lumps antigen and PCR tests together and to see what units that jurisdiction uses for test reporting.

In most states, the totalTestResults field is currently computed by adding positive and negative values because, historically, some states do not report totals, and to work around different reporting cadences for cases and tests. In Colorado, Delaware, the District of Columbia, Florida, Hawaii, Minnesota, Nevada, New York, North Dakota, Pennsylvania, Rhode Island, Virginia, Washington, and Wisconsin, where reliable testing encounters figures are available with a complete time series, we directly report those figures in this field. In Alaska, America Samoa, Arizona, Arkansas, California, Connecticut, Georgia, Illinois, Indiana, Kentucky, Maine, Maryland, Massachusetts, Michigan, Missouri, Montana, Nebraska, New Hampshire, New Mexico, North Carolina, Ohio, Oregon, South Dakota, Tennessee, Texas, Utah, Vermont, West Virginia, and Wyoming, where reliable specimens figures are available with a complete time series, we directly report those figures in this field. In Alabama and Idaho where reliable unique people figures are available with a complete time series, we directly report those figures in this field. We are in the process of switching all states over to use directly reported total figures, using a policy of preferring testing encounters, specimens, and people, in that order.
Returns null if no data is available
totalTestResultsIncrease: Field type: integer
New tests
Daily increase in totalTestResults, calculated from the previous day’s value. This calculation includes all the caveats associated with Total tests/totalTestResults, and we recommend against using it at the state/territory level.
Returns null if no data is available

All COVID data for the US on a specific date.

View data source for US historic values for a date

JSON format

/v1/us/{date}.json

Example: https://api.covidtracking.com/v1/us/20200501.json

CSV format

/v1/us/{date}.csv

Example: https://api.covidtracking.com/v1/us/20200501.csv

Fields

date: Field type: integer
Date
Date on which data was collected by The COVID Tracking Project.
dateChecked: Field type: string
Deprecated. This is an old label for lastUpdateEt.
death: Field type: integer
Deaths (confirmed and probable)
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 some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for fatalities, the metric includes only deaths with COVID-19 listed on the death certificate, unless deaths among cases is a more reliable metric in the state.
Returns null if no data is available
deathIncrease: Field type: integer
New deaths
Daily increase in death, calculated from the previous day’s value.
Returns null if no data is available
hash: Field type: string
A hash for this record
hospitalized: Field type: integer
Deprecated. Old label for hospitalizedCumulative.

Returns null if no data is available
hospitalizedCumulative: Field type: integer
Cumulative hospitalized/Ever hospitalized
Total number of individuals who have ever been hospitalized with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients hospitalized with confirmed or suspected COVID-19 cases.
Returns null if no data is available
hospitalizedCurrently: Field type: integer
Currently hospitalized/Now hospitalized
Individuals who are currently hospitalized with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients hospitalized with confirmed or suspected COVID-19 cases.
Returns null if no data is available
hospitalizedIncrease: Field type: integer
New total hospitalizations
Daily increase in hospitalizedCumulative, calculated from the previous day’s value.
Returns null if no data is available
inIcuCumulative: Field type: integer
Cumulative in ICU/Ever in ICU
Total number of individuals who have ever been hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients in the ICU with confirmed or suspected COVID-19 cases.
Returns null if no data is available
inIcuCurrently: Field type: integer
Currently in ICU/Now in ICU
Individuals who are currently hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients in the ICU with confirmed or suspected COVID-19 cases.
Returns null if no data is available
lastModified: Field type: string
Deprecated. Old label for lastUpdateET.
negative: Field type: integer
Negative PCR tests (people)
Total number of unique people with a completed PCR test that returns negative. 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. Due to complex reporting procedures, this number might be mixing units and therefore, at best, it should only be considered an estimate of the number of people with a completed PCR test that return negative.
Returns null if no data is available
negativeIncrease: Field type: integer
Increase in negative computed by subtracting the value of negative for the previous day from the value for negative from the current day.

Returns null if no data is available
onVentilatorCumulative: Field type: integer
Cumulative on ventilator/Ever on ventilator
Total number of individuals who have ever been hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients on ventilation with confirmed or suspected COVID-19 cases.
Returns null if no data is available
onVentilatorCurrently: Field type: integer
Currently on ventilator/Now on ventilator
Individuals who are currently hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients on ventilation with confirmed or suspected COVID-19 cases.
Returns null if no data is available
pending: Field type: integer
Pending
Total number of viral tests that have not been completed as reported by the state or territory.
Returns null if no data is available
posNeg: Field type: integer
Deprecated. Computed by adding positive and negative values.

Returns null if no data is available
positive: Field type: integer
Cases (confirmed plus probable)
Total number of confirmed plus probable cases of COVID-19 reported by the state or territory, ideally per the August 5, 2020 CSTE case definition. Some states are following the older April 5th, 2020 CSTE case definition or using their own custom definitions. Not all states and territories report probable cases. If a state is not reporting probable cases, this field will just represent confirmed cases.
Returns null if no data is available
positiveIncrease: Field type: integer
New cases
The daily increase in API field positive, which measures Cases (confirmed plus probable) calculated based on the previous day’s value.
Returns null if no data is available
recovered: Field type: integer
Recovered
Total number of people that are identified as recovered from COVID-19. States provide very disparate definitions on what constitutes a “recovered” COVID-19 case. Types of “recovered” cases include those who are discharged from hospitals, released from isolation after meeting CDC guidance on symptoms cessation, or those who have not been identified as fatalities after a number of days (30 or more) post disease onset. Specifics vary for each state or territory.
Returns null if no data is available
states: Field type: integer
States
Only available in national records. The number of states and territories included in the US dataset for this day.
total: Field type: integer
Deprecated. Computed by adding positive, negative, and pending values.

Returns null if no data is available
totalTestResults: Field type: integer
Total test results
At the national level, this metric is a summary statistic which, because of the variation in test reporting methods, is at best an estimate of US viral (PCR) testing. Some states/territories report tests in units of test encounters, some report tests in units of specimens, and some report tests in units of unique people. Moreover, some jurisdictions include antigen tests in their total test counts without reporting a separate total of viral (PCR) tests. Therefore, this value is an aggregate calculation of heterogeneous figures. Please consult each state or territory’s individual data page to see whether that jurisdiction lumps antigen and PCR tests together and to see what units that jurisdiction uses for test reporting.

In most states, the totalTestResults field is currently computed by adding positive and negative values because, historically, some states do not report totals, and to work around different reporting cadences for cases and tests. In Colorado, Delaware, the District of Columbia, Florida, Hawaii, Minnesota, Nevada, New York, North Dakota, Pennsylvania, Rhode Island, Virginia, Washington, and Wisconsin, where reliable testing encounters figures are available with a complete time series, we directly report those figures in this field. In Alaska, America Samoa, Arizona, Arkansas, California, Connecticut, Georgia, Illinois, Indiana, Kentucky, Maine, Maryland, Massachusetts, Michigan, Missouri, Montana, Nebraska, New Hampshire, New Mexico, North Carolina, Ohio, Oregon, South Dakota, Tennessee, Texas, Utah, Vermont, West Virginia, and Wyoming, where reliable specimens figures are available with a complete time series, we directly report those figures in this field. In Alabama and Idaho where reliable unique people figures are available with a complete time series, we directly report those figures in this field. We are in the process of switching all states over to use directly reported total figures, using a policy of preferring testing encounters, specimens, and people, in that order.
Returns null if no data is available
totalTestResultsIncrease: Field type: integer
New tests
Daily increase in totalTestResults, calculated from the previous day’s value. This calculation includes all the caveats associated with Total tests/totalTestResults, and we recommend against using it at the state/territory level.
Returns null if no data is available

States Current and Historical Data

Basic information about states, including notes about our methodology and the websites we use to check for data.

View data source for State metadata

JSON format

/v1/states/info.json

Example: https://api.covidtracking.com/v1/states/info.json

CSV format

/v1/states/info.csv

Example: https://api.covidtracking.com/v1/states/info.csv

Fields

covid19Site: Field type: string
URL to the state's COVID website
covid19SiteOld: Field type: string
URL to the state's old COVID website
covid19SiteQuaternary: Field type: string
URL to the state's fourth COVID website
covid19SiteQuinary: Field type: string
URL to the state's fifth COVID website
covid19SiteSecondary: Field type: string
URL to the state's secondary COVID website
covid19SiteTertiary: Field type: string
URL to the state's third COVID website
covidTrackingProjectPreferredTotalTestField: Field type: string
COVID Tracking Project preferred total test field
Locator field that explains which API fields The COVID Tracking Project prefers for each state’s “New tests” chart and on the state’s history page on our website. Selects from the following options in order of priority: totalTestEncountersViral, totalTestsViral, totalTestsPeopleViral, or—where those units are all missing a sufficient time series—totalTestResults.
covidTrackingProjectPreferredTotalTestUnits: Field type: string
COVID Tracking Project preferred total test units
Label indicating which units The COVID Tracking Project prefers for each state’s “New tests” chart and on the state’s history page on our website. Selects from the following options in order of priority: test encounters, specimens, people, or—where those units are all missing a sufficent time series—negatives plus positives.
fips: Field type: string
FIPS code
State FIPS code
name: Field type: string
The name of the state
notes: Field type: string
Notes about the state
pui: Field type: string
Deprecated
pum: Field type: boolean
Deprecated
state: Field type: string
State (or territory)
Two-letter abbreviation for the state or territory.
totalTestResultsField: Field type: string
Source field for total test results.
twitter: Field type: string
The state's COVID-related Twitter handle

Metadata about a specific state

JSON format

/v1/states/{state}/info.json

Example: https://api.covidtracking.com/v1/states/ca/info.json

CSV format

/v1/states/{state}/info.csv

Example: https://api.covidtracking.com/v1/states/ca/info.csv

Fields

covid19Site: Field type: string
URL to the state's COVID website
covid19SiteOld: Field type: string
URL to the state's old COVID website
covid19SiteQuaternary: Field type: string
URL to the state's fourth COVID website
covid19SiteQuinary: Field type: string
URL to the state's fifth COVID website
covid19SiteSecondary: Field type: string
URL to the state's secondary COVID website
covid19SiteTertiary: Field type: string
URL to the state's third COVID website
covidTrackingProjectPreferredTotalTestField: Field type: string
COVID Tracking Project preferred total test field
Locator field that explains which API fields The COVID Tracking Project prefers for each state’s “New tests” chart and on the state’s history page on our website. Selects from the following options in order of priority: totalTestEncountersViral, totalTestsViral, totalTestsPeopleViral, or—where those units are all missing a sufficient time series—totalTestResults.
covidTrackingProjectPreferredTotalTestUnits: Field type: string
COVID Tracking Project preferred total test units
Label indicating which units The COVID Tracking Project prefers for each state’s “New tests” chart and on the state’s history page on our website. Selects from the following options in order of priority: test encounters, specimens, people, or—where those units are all missing a sufficent time series—negatives plus positives.
fips: Field type: string
FIPS code
State FIPS code
name: Field type: string
The name of the state
notes: Field type: string
Notes about the state
pui: Field type: string
Deprecated
pum: Field type: boolean
Deprecated
state: Field type: string
State (or territory)
Two-letter abbreviation for the state or territory.
totalTestResultsField: Field type: string
Source field for total test results.
twitter: Field type: string
The state's COVID-related Twitter handle

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

View data source for Historic values for all states

JSON format

/v1/states/daily.json

Example: https://api.covidtracking.com/v1/states/daily.json

CSV format

/v1/states/daily.csv

Example: https://api.covidtracking.com/v1/states/daily.csv

Fields

checkTimeEt: Field type: string
Deprecated
commercialScore: Field type: integer
Deprecated

Returns null if no data is available
dataQualityGrade: Field type: string
Data Quality Grade
The COVID Tracking Project grade of the completeness of the data reporting by a state. See our State Grades page and our spreadsheet of grade factors for more information.
date: Field type: integer
Date
Date on which data was collected by The COVID Tracking Project.
dateChecked: Field type: string
Deprecated
dateModified: Field type: string
Deprecated, use lastUpdateEt instead
death: Field type: integer
Deaths (confirmed and probable)
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 some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for fatalities, the metric includes only deaths with COVID-19 listed on the death certificate, unless deaths among cases is a more reliable metric in the state.
Returns null if no data is available
deathConfirmed: Field type: integer
Deaths (confirmed)
Total fatalities with confirmed COVID-19 case diagnosis (per the expanded CSTE case definition of April 5th, 2020 approved by the CDC). In some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for confirmed fatalities, the metric includes only lab-confirmed deaths with COVID-19 listed on the death certificate, unless deaths among confirmed cases is a more reliable metric in the state.
Returns null if no data is available
deathIncrease: Field type: integer
New deaths
Daily increase in death, calculated from the previous day’s value.
Returns null if no data is available
deathProbable: Field type: integer
Deaths (probable)
Total fatalities with probable COVID-19 case diagnosis (per the expanded CSTE case definition of April 5th, 2020 approved by the CDC). In some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for probable fatalities, the metric includes only probable fatalities with COVID-19 listed on the death certificate, unless deaths among probable cases is a more reliable metric in the state.
Returns null if no data is available
fips: Field type: string
FIPS code
State FIPS code
grade: Field type: string
Deprecated
hash: Field type: string
Deprecated - A hash of the current record.
hospitalized: Field type: integer
Deprecated

Returns null if no data is available
hospitalizedCumulative: Field type: integer
Cumulative hospitalized/Ever hospitalized
Total number of individuals who have ever been hospitalized with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients hospitalized with confirmed or suspected COVID-19 cases.
Returns null if no data is available
hospitalizedCurrently: Field type: integer
Currently hospitalized/Now hospitalized
Individuals who are currently hospitalized with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients hospitalized with confirmed or suspected COVID-19 cases.
Returns null if no data is available
hospitalizedDischarged: Field type: integer
Hospital discharges
The total number of COVID-19 patients discharged from the hospital. Wherever possible, we include patients with confirmed or suspected COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients or patients with suspected COVID-19 are included.
Returns null if no data is available
hospitalizedIncrease: Field type: integer
New total hospitalizations
Daily increase in hospitalizedCumulative, calculated from the previous day’s value.
Returns null if no data is available
inIcuCumulative: Field type: integer
Cumulative in ICU/Ever in ICU
Total number of individuals who have ever been hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients in the ICU with confirmed or suspected COVID-19 cases.
Returns null if no data is available
inIcuCurrently: Field type: integer
Currently in ICU/Now in ICU
Individuals who are currently hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients in the ICU with confirmed or suspected COVID-19 cases.
Returns null if no data is available
lastUpdateEt: Field type: string
Last Update (ET)
Date and time in Eastern time the state or territory last updated the data.
negative: Field type: integer
Negative PCR tests (people)
Total number of unique people with a completed PCR test that returns negative. 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. Due to complex reporting procedures, this number might be mixing units and therefore, at best, it should only be considered an estimate of the number of people with a completed PCR test that return negative.
Returns null if no data is available
negativeIncrease: Field type: integer
Deprecated

Returns null if no data is available
negativeRegularScore: Field type: integer
Deprecated

Returns null if no data is available
negativeScore: Field type: integer
Deprecated

Returns null if no data is available
negativeTestsAntibody: Field type: integer
Negative antibody tests (specimens)
The total number of completed antibody tests that return negative as reported by the state or territory.
Returns null if no data is available
negativeTestsPeopleAntibody: Field type: integer
Negative antibody tests (people)
The total number of unique people with completed antibody tests that return negative as reported by the state or territory.
Returns null if no data is available
negativeTestsViral: Field type: integer
Negative PCR tests (specimens)
Total number of completed PCR tests (or specimens tested) that return negative as reported by the state or territory. 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. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
onVentilatorCumulative: Field type: integer
Cumulative on ventilator/Ever on ventilator
Total number of individuals who have ever been hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients on ventilation with confirmed or suspected COVID-19 cases.
Returns null if no data is available
onVentilatorCurrently: Field type: integer
Currently on ventilator/Now on ventilator
Individuals who are currently hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients on ventilation with confirmed or suspected COVID-19 cases.
Returns null if no data is available
pending: Field type: integer
Pending
Total number of viral tests that have not been completed as reported by the state or territory.
Returns null if no data is available
posNeg: Field type: integer
Deprecated

Returns null if no data is available
positive: Field type: integer
Cases (confirmed plus probable)
Total number of confirmed plus probable cases of COVID-19 reported by the state or territory, ideally per the August 5, 2020 CSTE case definition. Some states are following the older April 5th, 2020 CSTE case definition or using their own custom definitions. Not all states and territories report probable cases. If a state is not reporting probable cases, this field will just represent confirmed cases.
Returns null if no data is available
positiveCasesViral: Field type: integer
Confirmed Cases
Total number of unique people with a positive PCR or other approved nucleic acid amplification test (NAAT), as reported by the state or territory. This is equivalent to a confirmed case as per the CSTE case definitions of August 5th, 2020 and April 5th, 2020. If we discover a jurisdiction is labeling cases as confirmed using other evidence (e.g. positive antigen tests), we will annotate that state or territory’s data accordingly.
Returns null if no data is available
positiveIncrease: Field type: integer
New cases
The daily increase in API field positive, which measures Cases (confirmed plus probable) calculated based on the previous day’s value.
Returns null if no data is available
positiveScore: Field type: integer
Deprecated

Returns null if no data is available
positiveTestsAntibody: Field type: integer
Positive antibody tests (specimens)
Total number of completed antibody tests that return positive as reported by the state or territory.
Returns null if no data is available
positiveTestsAntigen: Field type: integer
Positive antigen tests (specimens)
Total number of completed antigen tests that return positive as reported by the state or territory.
Returns null if no data is available
positiveTestsPeopleAntibody: Field type: integer
Positive antibody tests (people)
The total number of unique people with completed antibody tests that return positive as reported by the state or territory.
Returns null if no data is available
positiveTestsPeopleAntigen: Field type: integer
Positive antigen tests (people)
Total number of unique people with a completed antigen test that returned positive as reported by the state or territory.
Returns null if no data is available
positiveTestsViral: Field type: integer
Positive PCR tests (specimens)
Total number of completed PCR tests (or specimens tested) that return positive as reported by the state or territory. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
probableCases: Field type: integer
Probable Cases
Total number of probable cases of COVID-19 as reported by the state or territory, ideally per the August 5, 2020 CSTE case definition. By this definition, a probable case is someone who tests positive via antigen without a positive PCR or other approved nucleic acid amplification test (NAAT), someone with clinical and epidemiological evidence of COVID-19 infection with no confirmatory laboratory testing performed for SARS-CoV-2, or someone with COVID-19 listed on their death certificate with no confirmatory laboratory testing performed for SARS-CoV-2. Some states are following the older April 5th, 2020 CSTE case definition or using their own custom definitions.
Returns null if no data is available
recovered: Field type: integer
Recovered
Total number of people that are identified as recovered from COVID-19. States provide very disparate definitions on what constitutes a “recovered” COVID-19 case. Types of “recovered” cases include those who are discharged from hospitals, released from isolation after meeting CDC guidance on symptoms cessation, or those who have not been identified as fatalities after a number of days (30 or more) post disease onset. Specifics vary for each state or territory.
Returns null if no data is available
score: Field type: integer
Deprecated

Returns null if no data is available
state: Field type: string
State (or territory)
Two-letter abbreviation for the state or territory.
total: Field type: integer
Deprecated

Returns null if no data is available
totalTestEncountersViral: Field type: integer
Total PCR tests (test encounters)
Total number of people tested per day via PCR testing as reported by the state or territory. The count for this metric is incremented up by one for each day on which an individual person is tested, no matter how many specimens are collected from that person on that day. If an individual person is tested twice a day on three different days, this count will increment up by three. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
totalTestResults: Field type: integer
Total test results
At the national level, this metric is a summary statistic which, because of the variation in test reporting methods, is at best an estimate of US viral (PCR) testing. Some states/territories report tests in units of test encounters, some report tests in units of specimens, and some report tests in units of unique people. Moreover, some jurisdictions include antigen tests in their total test counts without reporting a separate total of viral (PCR) tests. Therefore, this value is an aggregate calculation of heterogeneous figures. Please consult each state or territory’s individual data page to see whether that jurisdiction lumps antigen and PCR tests together and to see what units that jurisdiction uses for test reporting.

In most states, the totalTestResults field is currently computed by adding positive and negative values because, historically, some states do not report totals, and to work around different reporting cadences for cases and tests. In Colorado, Delaware, the District of Columbia, Florida, Hawaii, Minnesota, Nevada, New York, North Dakota, Pennsylvania, Rhode Island, Virginia, Washington, and Wisconsin, where reliable testing encounters figures are available with a complete time series, we directly report those figures in this field. In Alaska, America Samoa, Arizona, Arkansas, California, Connecticut, Georgia, Illinois, Indiana, Kentucky, Maine, Maryland, Massachusetts, Michigan, Missouri, Montana, Nebraska, New Hampshire, New Mexico, North Carolina, Ohio, Oregon, South Dakota, Tennessee, Texas, Utah, Vermont, West Virginia, and Wyoming, where reliable specimens figures are available with a complete time series, we directly report those figures in this field. In Alabama and Idaho where reliable unique people figures are available with a complete time series, we directly report those figures in this field. We are in the process of switching all states over to use directly reported total figures, using a policy of preferring testing encounters, specimens, and people, in that order.
Returns null if no data is available
totalTestResultsIncrease: Field type: integer
New tests
Daily increase in totalTestResults, calculated from the previous day’s value. This calculation includes all the caveats associated with Total tests/totalTestResults, and we recommend against using it at the state/territory level.
Returns null if no data is available
totalTestResultsSource: Field type: string
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.
totalTestsAntibody: Field type: integer
Total antibody tests (specimens)
Total number of completed antibody tests as reported by the state or territory.
Returns null if no data is available
totalTestsAntigen: Field type: integer
Total antigen tests (specimens)
Total number of completed antigen tests, as reported by the state or territory.
Returns null if no data is available
totalTestsPeopleAntibody: Field type: integer
Total antibody tests (people)
The total number of unique people who have been tested at least once via antibody testing as reported by the state or territory.
Returns null if no data is available
totalTestsPeopleAntigen: Field type: integer
Total antigen tests (people)
Total number of unique people who have been tested at least once via antigen testing, as reported by the state or territory.
Returns null if no data is available
totalTestsPeopleViral: Field type: integer
Total PCR tests (people)
Total number of unique people tested at least once via PCR testing, as reported by the state or territory. The count for this metric is incremented up only the first time an individual person is tested and their result is reported. Future tests of the same person will not be added to this count.

In the case where the state only provides negative cases, this field is calculated as the summation of people who tested positive (“Positive Cases (People”) and the number of people who tested negative (“Negative (People or Cases)”). If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
totalTestsViral: Field type: integer
Total PCR tests (specimens)
Total number of PCR tests (or specimens tested) as reported by the state or territory. The count for this metric is incremented up each time a specimen is tested and the result is reported. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly. For states with ambiguous annotations, we have assigned their total tests to this category; these states and territories are identified in the new API field covidTrackingProjectPreferredTotalTestUnits as having “Unclear units.”
Returns null if no data is available

The most recent COVID data for every state. The current value may be different than today.

View data source for Current values for all states

JSON format

/v1/states/current.json

Example: https://api.covidtracking.com/v1/states/current.json

CSV format

/v1/states/current.csv

Example: https://api.covidtracking.com/v1/states/current.csv

Fields

checkTimeEt: Field type: string
Deprecated
commercialScore: Field type: integer
Deprecated

Returns null if no data is available
dataQualityGrade: Field type: string
Data Quality Grade
The COVID Tracking Project grade of the completeness of the data reporting by a state. See our State Grades page and our spreadsheet of grade factors for more information.
date: Field type: integer
Date
Date on which data was collected by The COVID Tracking Project.
dateChecked: Field type: string
Deprecated
dateModified: Field type: string
Deprecated, use lastUpdateEt instead
death: Field type: integer
Deaths (confirmed and probable)
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 some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for fatalities, the metric includes only deaths with COVID-19 listed on the death certificate, unless deaths among cases is a more reliable metric in the state.
Returns null if no data is available
deathConfirmed: Field type: integer
Deaths (confirmed)
Total fatalities with confirmed COVID-19 case diagnosis (per the expanded CSTE case definition of April 5th, 2020 approved by the CDC). In some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for confirmed fatalities, the metric includes only lab-confirmed deaths with COVID-19 listed on the death certificate, unless deaths among confirmed cases is a more reliable metric in the state.
Returns null if no data is available
deathIncrease: Field type: integer
New deaths
Daily increase in death, calculated from the previous day’s value.
Returns null if no data is available
deathProbable: Field type: integer
Deaths (probable)
Total fatalities with probable COVID-19 case diagnosis (per the expanded CSTE case definition of April 5th, 2020 approved by the CDC). In some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for probable fatalities, the metric includes only probable fatalities with COVID-19 listed on the death certificate, unless deaths among probable cases is a more reliable metric in the state.
Returns null if no data is available
fips: Field type: string
FIPS code
State FIPS code
grade: Field type: string
Deprecated
hash: Field type: string
Deprecated - A hash of the current record.
hospitalized: Field type: integer
Deprecated

Returns null if no data is available
hospitalizedCumulative: Field type: integer
Cumulative hospitalized/Ever hospitalized
Total number of individuals who have ever been hospitalized with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients hospitalized with confirmed or suspected COVID-19 cases.
Returns null if no data is available
hospitalizedCurrently: Field type: integer
Currently hospitalized/Now hospitalized
Individuals who are currently hospitalized with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients hospitalized with confirmed or suspected COVID-19 cases.
Returns null if no data is available
hospitalizedDischarged: Field type: integer
Hospital discharges
The total number of COVID-19 patients discharged from the hospital. Wherever possible, we include patients with confirmed or suspected COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients or patients with suspected COVID-19 are included.
Returns null if no data is available
hospitalizedIncrease: Field type: integer
New total hospitalizations
Daily increase in hospitalizedCumulative, calculated from the previous day’s value.
Returns null if no data is available
inIcuCumulative: Field type: integer
Cumulative in ICU/Ever in ICU
Total number of individuals who have ever been hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients in the ICU with confirmed or suspected COVID-19 cases.
Returns null if no data is available
inIcuCurrently: Field type: integer
Currently in ICU/Now in ICU
Individuals who are currently hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients in the ICU with confirmed or suspected COVID-19 cases.
Returns null if no data is available
lastUpdateEt: Field type: string
Last Update (ET)
Date and time in Eastern time the state or territory last updated the data.
negative: Field type: integer
Negative PCR tests (people)
Total number of unique people with a completed PCR test that returns negative. 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. Due to complex reporting procedures, this number might be mixing units and therefore, at best, it should only be considered an estimate of the number of people with a completed PCR test that return negative.
Returns null if no data is available
negativeIncrease: Field type: integer
Deprecated

Returns null if no data is available
negativeRegularScore: Field type: integer
Deprecated

Returns null if no data is available
negativeScore: Field type: integer
Deprecated

Returns null if no data is available
negativeTestsAntibody: Field type: integer
Negative antibody tests (specimens)
The total number of completed antibody tests that return negative as reported by the state or territory.
Returns null if no data is available
negativeTestsPeopleAntibody: Field type: integer
Negative antibody tests (people)
The total number of unique people with completed antibody tests that return negative as reported by the state or territory.
Returns null if no data is available
negativeTestsViral: Field type: integer
Negative PCR tests (specimens)
Total number of completed PCR tests (or specimens tested) that return negative as reported by the state or territory. 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. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
onVentilatorCumulative: Field type: integer
Cumulative on ventilator/Ever on ventilator
Total number of individuals who have ever been hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients on ventilation with confirmed or suspected COVID-19 cases.
Returns null if no data is available
onVentilatorCurrently: Field type: integer
Currently on ventilator/Now on ventilator
Individuals who are currently hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients on ventilation with confirmed or suspected COVID-19 cases.
Returns null if no data is available
pending: Field type: integer
Pending
Total number of viral tests that have not been completed as reported by the state or territory.
Returns null if no data is available
posNeg: Field type: integer
Deprecated

Returns null if no data is available
positive: Field type: integer
Cases (confirmed plus probable)
Total number of confirmed plus probable cases of COVID-19 reported by the state or territory, ideally per the August 5, 2020 CSTE case definition. Some states are following the older April 5th, 2020 CSTE case definition or using their own custom definitions. Not all states and territories report probable cases. If a state is not reporting probable cases, this field will just represent confirmed cases.
Returns null if no data is available
positiveCasesViral: Field type: integer
Confirmed Cases
Total number of unique people with a positive PCR or other approved nucleic acid amplification test (NAAT), as reported by the state or territory. This is equivalent to a confirmed case as per the CSTE case definitions of August 5th, 2020 and April 5th, 2020. If we discover a jurisdiction is labeling cases as confirmed using other evidence (e.g. positive antigen tests), we will annotate that state or territory’s data accordingly.
Returns null if no data is available
positiveIncrease: Field type: integer
New cases
The daily increase in API field positive, which measures Cases (confirmed plus probable) calculated based on the previous day’s value.
Returns null if no data is available
positiveScore: Field type: integer
Deprecated

Returns null if no data is available
positiveTestsAntibody: Field type: integer
Positive antibody tests (specimens)
Total number of completed antibody tests that return positive as reported by the state or territory.
Returns null if no data is available
positiveTestsAntigen: Field type: integer
Positive antigen tests (specimens)
Total number of completed antigen tests that return positive as reported by the state or territory.
Returns null if no data is available
positiveTestsPeopleAntibody: Field type: integer
Positive antibody tests (people)
The total number of unique people with completed antibody tests that return positive as reported by the state or territory.
Returns null if no data is available
positiveTestsPeopleAntigen: Field type: integer
Positive antigen tests (people)
Total number of unique people with a completed antigen test that returned positive as reported by the state or territory.
Returns null if no data is available
positiveTestsViral: Field type: integer
Positive PCR tests (specimens)
Total number of completed PCR tests (or specimens tested) that return positive as reported by the state or territory. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
probableCases: Field type: integer
Probable Cases
Total number of probable cases of COVID-19 as reported by the state or territory, ideally per the August 5, 2020 CSTE case definition. By this definition, a probable case is someone who tests positive via antigen without a positive PCR or other approved nucleic acid amplification test (NAAT), someone with clinical and epidemiological evidence of COVID-19 infection with no confirmatory laboratory testing performed for SARS-CoV-2, or someone with COVID-19 listed on their death certificate with no confirmatory laboratory testing performed for SARS-CoV-2. Some states are following the older April 5th, 2020 CSTE case definition or using their own custom definitions.
Returns null if no data is available
recovered: Field type: integer
Recovered
Total number of people that are identified as recovered from COVID-19. States provide very disparate definitions on what constitutes a “recovered” COVID-19 case. Types of “recovered” cases include those who are discharged from hospitals, released from isolation after meeting CDC guidance on symptoms cessation, or those who have not been identified as fatalities after a number of days (30 or more) post disease onset. Specifics vary for each state or territory.
Returns null if no data is available
score: Field type: integer
Deprecated

Returns null if no data is available
state: Field type: string
State (or territory)
Two-letter abbreviation for the state or territory.
total: Field type: integer
Deprecated

Returns null if no data is available
totalTestEncountersViral: Field type: integer
Total PCR tests (test encounters)
Total number of people tested per day via PCR testing as reported by the state or territory. The count for this metric is incremented up by one for each day on which an individual person is tested, no matter how many specimens are collected from that person on that day. If an individual person is tested twice a day on three different days, this count will increment up by three. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
totalTestResults: Field type: integer
Total test results
At the national level, this metric is a summary statistic which, because of the variation in test reporting methods, is at best an estimate of US viral (PCR) testing. Some states/territories report tests in units of test encounters, some report tests in units of specimens, and some report tests in units of unique people. Moreover, some jurisdictions include antigen tests in their total test counts without reporting a separate total of viral (PCR) tests. Therefore, this value is an aggregate calculation of heterogeneous figures. Please consult each state or territory’s individual data page to see whether that jurisdiction lumps antigen and PCR tests together and to see what units that jurisdiction uses for test reporting.

In most states, the totalTestResults field is currently computed by adding positive and negative values because, historically, some states do not report totals, and to work around different reporting cadences for cases and tests. In Colorado, Delaware, the District of Columbia, Florida, Hawaii, Minnesota, Nevada, New York, North Dakota, Pennsylvania, Rhode Island, Virginia, Washington, and Wisconsin, where reliable testing encounters figures are available with a complete time series, we directly report those figures in this field. In Alaska, America Samoa, Arizona, Arkansas, California, Connecticut, Georgia, Illinois, Indiana, Kentucky, Maine, Maryland, Massachusetts, Michigan, Missouri, Montana, Nebraska, New Hampshire, New Mexico, North Carolina, Ohio, Oregon, South Dakota, Tennessee, Texas, Utah, Vermont, West Virginia, and Wyoming, where reliable specimens figures are available with a complete time series, we directly report those figures in this field. In Alabama and Idaho where reliable unique people figures are available with a complete time series, we directly report those figures in this field. We are in the process of switching all states over to use directly reported total figures, using a policy of preferring testing encounters, specimens, and people, in that order.
Returns null if no data is available
totalTestResultsIncrease: Field type: integer
New tests
Daily increase in totalTestResults, calculated from the previous day’s value. This calculation includes all the caveats associated with Total tests/totalTestResults, and we recommend against using it at the state/territory level.
Returns null if no data is available
totalTestResultsSource: Field type: string
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.
totalTestsAntibody: Field type: integer
Total antibody tests (specimens)
Total number of completed antibody tests as reported by the state or territory.
Returns null if no data is available
totalTestsAntigen: Field type: integer
Total antigen tests (specimens)
Total number of completed antigen tests, as reported by the state or territory.
Returns null if no data is available
totalTestsPeopleAntibody: Field type: integer
Total antibody tests (people)
The total number of unique people who have been tested at least once via antibody testing as reported by the state or territory.
Returns null if no data is available
totalTestsPeopleAntigen: Field type: integer
Total antigen tests (people)
Total number of unique people who have been tested at least once via antigen testing, as reported by the state or territory.
Returns null if no data is available
totalTestsPeopleViral: Field type: integer
Total PCR tests (people)
Total number of unique people tested at least once via PCR testing, as reported by the state or territory. The count for this metric is incremented up only the first time an individual person is tested and their result is reported. Future tests of the same person will not be added to this count.

In the case where the state only provides negative cases, this field is calculated as the summation of people who tested positive (“Positive Cases (People”) and the number of people who tested negative (“Negative (People or Cases)”). If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
totalTestsViral: Field type: integer
Total PCR tests (specimens)
Total number of PCR tests (or specimens tested) as reported by the state or territory. The count for this metric is incremented up each time a specimen is tested and the result is reported. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly. For states with ambiguous annotations, we have assigned their total tests to this category; these states and territories are identified in the new API field covidTrackingProjectPreferredTotalTestUnits as having “Unclear units.”
Returns null if no data is available

The most recent COVID data for a single state. The current value may be different than today. Use lower-case state codes in the URL.

View data source for Current values for a single state

JSON format

/v1/states/{state}/current.json

Example: https://api.covidtracking.com/v1/states/ca/current.json

CSV format

/v1/states/{state}/current.csv

Example: https://api.covidtracking.com/v1/states/ca/current.csv

Fields

checkTimeEt: Field type: string
Deprecated
commercialScore: Field type: integer
Deprecated

Returns null if no data is available
dataQualityGrade: Field type: string
Data Quality Grade
The COVID Tracking Project grade of the completeness of the data reporting by a state. See our State Grades page and our spreadsheet of grade factors for more information.
date: Field type: integer
Date
Date on which data was collected by The COVID Tracking Project.
dateChecked: Field type: string
Deprecated
dateModified: Field type: string
Deprecated, use lastUpdateEt instead
death: Field type: integer
Deaths (confirmed and probable)
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 some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for fatalities, the metric includes only deaths with COVID-19 listed on the death certificate, unless deaths among cases is a more reliable metric in the state.
Returns null if no data is available
deathConfirmed: Field type: integer
Deaths (confirmed)
Total fatalities with confirmed COVID-19 case diagnosis (per the expanded CSTE case definition of April 5th, 2020 approved by the CDC). In some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for confirmed fatalities, the metric includes only lab-confirmed deaths with COVID-19 listed on the death certificate, unless deaths among confirmed cases is a more reliable metric in the state.
Returns null if no data is available
deathIncrease: Field type: integer
New deaths
Daily increase in death, calculated from the previous day’s value.
Returns null if no data is available
deathProbable: Field type: integer
Deaths (probable)
Total fatalities with probable COVID-19 case diagnosis (per the expanded CSTE case definition of April 5th, 2020 approved by the CDC). In some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for probable fatalities, the metric includes only probable fatalities with COVID-19 listed on the death certificate, unless deaths among probable cases is a more reliable metric in the state.
Returns null if no data is available
fips: Field type: string
FIPS code
State FIPS code
grade: Field type: string
Deprecated
hash: Field type: string
Deprecated - A hash of the current record.
hospitalized: Field type: integer
Deprecated

Returns null if no data is available
hospitalizedCumulative: Field type: integer
Cumulative hospitalized/Ever hospitalized
Total number of individuals who have ever been hospitalized with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients hospitalized with confirmed or suspected COVID-19 cases.
Returns null if no data is available
hospitalizedCurrently: Field type: integer
Currently hospitalized/Now hospitalized
Individuals who are currently hospitalized with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients hospitalized with confirmed or suspected COVID-19 cases.
Returns null if no data is available
hospitalizedDischarged: Field type: integer
Hospital discharges
The total number of COVID-19 patients discharged from the hospital. Wherever possible, we include patients with confirmed or suspected COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients or patients with suspected COVID-19 are included.
Returns null if no data is available
hospitalizedIncrease: Field type: integer
New total hospitalizations
Daily increase in hospitalizedCumulative, calculated from the previous day’s value.
Returns null if no data is available
inIcuCumulative: Field type: integer
Cumulative in ICU/Ever in ICU
Total number of individuals who have ever been hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients in the ICU with confirmed or suspected COVID-19 cases.
Returns null if no data is available
inIcuCurrently: Field type: integer
Currently in ICU/Now in ICU
Individuals who are currently hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients in the ICU with confirmed or suspected COVID-19 cases.
Returns null if no data is available
lastUpdateEt: Field type: string
Last Update (ET)
Date and time in Eastern time the state or territory last updated the data.
negative: Field type: integer
Negative PCR tests (people)
Total number of unique people with a completed PCR test that returns negative. 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. Due to complex reporting procedures, this number might be mixing units and therefore, at best, it should only be considered an estimate of the number of people with a completed PCR test that return negative.
Returns null if no data is available
negativeIncrease: Field type: integer
Deprecated

Returns null if no data is available
negativeRegularScore: Field type: integer
Deprecated

Returns null if no data is available
negativeScore: Field type: integer
Deprecated

Returns null if no data is available
negativeTestsAntibody: Field type: integer
Negative antibody tests (specimens)
The total number of completed antibody tests that return negative as reported by the state or territory.
Returns null if no data is available
negativeTestsPeopleAntibody: Field type: integer
Negative antibody tests (people)
The total number of unique people with completed antibody tests that return negative as reported by the state or territory.
Returns null if no data is available
negativeTestsViral: Field type: integer
Negative PCR tests (specimens)
Total number of completed PCR tests (or specimens tested) that return negative as reported by the state or territory. 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. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
onVentilatorCumulative: Field type: integer
Cumulative on ventilator/Ever on ventilator
Total number of individuals who have ever been hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients on ventilation with confirmed or suspected COVID-19 cases.
Returns null if no data is available
onVentilatorCurrently: Field type: integer
Currently on ventilator/Now on ventilator
Individuals who are currently hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients on ventilation with confirmed or suspected COVID-19 cases.
Returns null if no data is available
pending: Field type: integer
Pending
Total number of viral tests that have not been completed as reported by the state or territory.
Returns null if no data is available
posNeg: Field type: integer
Deprecated

Returns null if no data is available
positive: Field type: integer
Cases (confirmed plus probable)
Total number of confirmed plus probable cases of COVID-19 reported by the state or territory, ideally per the August 5, 2020 CSTE case definition. Some states are following the older April 5th, 2020 CSTE case definition or using their own custom definitions. Not all states and territories report probable cases. If a state is not reporting probable cases, this field will just represent confirmed cases.
Returns null if no data is available
positiveCasesViral: Field type: integer
Confirmed Cases
Total number of unique people with a positive PCR or other approved nucleic acid amplification test (NAAT), as reported by the state or territory. This is equivalent to a confirmed case as per the CSTE case definitions of August 5th, 2020 and April 5th, 2020. If we discover a jurisdiction is labeling cases as confirmed using other evidence (e.g. positive antigen tests), we will annotate that state or territory’s data accordingly.
Returns null if no data is available
positiveIncrease: Field type: integer
New cases
The daily increase in API field positive, which measures Cases (confirmed plus probable) calculated based on the previous day’s value.
Returns null if no data is available
positiveScore: Field type: integer
Deprecated

Returns null if no data is available
positiveTestsAntibody: Field type: integer
Positive antibody tests (specimens)
Total number of completed antibody tests that return positive as reported by the state or territory.
Returns null if no data is available
positiveTestsAntigen: Field type: integer
Positive antigen tests (specimens)
Total number of completed antigen tests that return positive as reported by the state or territory.
Returns null if no data is available
positiveTestsPeopleAntibody: Field type: integer
Positive antibody tests (people)
The total number of unique people with completed antibody tests that return positive as reported by the state or territory.
Returns null if no data is available
positiveTestsPeopleAntigen: Field type: integer
Positive antigen tests (people)
Total number of unique people with a completed antigen test that returned positive as reported by the state or territory.
Returns null if no data is available
positiveTestsViral: Field type: integer
Positive PCR tests (specimens)
Total number of completed PCR tests (or specimens tested) that return positive as reported by the state or territory. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
probableCases: Field type: integer
Probable Cases
Total number of probable cases of COVID-19 as reported by the state or territory, ideally per the August 5, 2020 CSTE case definition. By this definition, a probable case is someone who tests positive via antigen without a positive PCR or other approved nucleic acid amplification test (NAAT), someone with clinical and epidemiological evidence of COVID-19 infection with no confirmatory laboratory testing performed for SARS-CoV-2, or someone with COVID-19 listed on their death certificate with no confirmatory laboratory testing performed for SARS-CoV-2. Some states are following the older April 5th, 2020 CSTE case definition or using their own custom definitions.
Returns null if no data is available
recovered: Field type: integer
Recovered
Total number of people that are identified as recovered from COVID-19. States provide very disparate definitions on what constitutes a “recovered” COVID-19 case. Types of “recovered” cases include those who are discharged from hospitals, released from isolation after meeting CDC guidance on symptoms cessation, or those who have not been identified as fatalities after a number of days (30 or more) post disease onset. Specifics vary for each state or territory.
Returns null if no data is available
score: Field type: integer
Deprecated

Returns null if no data is available
state: Field type: string
State (or territory)
Two-letter abbreviation for the state or territory.
total: Field type: integer
Deprecated

Returns null if no data is available
totalTestEncountersViral: Field type: integer
Total PCR tests (test encounters)
Total number of people tested per day via PCR testing as reported by the state or territory. The count for this metric is incremented up by one for each day on which an individual person is tested, no matter how many specimens are collected from that person on that day. If an individual person is tested twice a day on three different days, this count will increment up by three. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
totalTestResults: Field type: integer
Total test results
At the national level, this metric is a summary statistic which, because of the variation in test reporting methods, is at best an estimate of US viral (PCR) testing. Some states/territories report tests in units of test encounters, some report tests in units of specimens, and some report tests in units of unique people. Moreover, some jurisdictions include antigen tests in their total test counts without reporting a separate total of viral (PCR) tests. Therefore, this value is an aggregate calculation of heterogeneous figures. Please consult each state or territory’s individual data page to see whether that jurisdiction lumps antigen and PCR tests together and to see what units that jurisdiction uses for test reporting.

In most states, the totalTestResults field is currently computed by adding positive and negative values because, historically, some states do not report totals, and to work around different reporting cadences for cases and tests. In Colorado, Delaware, the District of Columbia, Florida, Hawaii, Minnesota, Nevada, New York, North Dakota, Pennsylvania, Rhode Island, Virginia, Washington, and Wisconsin, where reliable testing encounters figures are available with a complete time series, we directly report those figures in this field. In Alaska, America Samoa, Arizona, Arkansas, California, Connecticut, Georgia, Illinois, Indiana, Kentucky, Maine, Maryland, Massachusetts, Michigan, Missouri, Montana, Nebraska, New Hampshire, New Mexico, North Carolina, Ohio, Oregon, South Dakota, Tennessee, Texas, Utah, Vermont, West Virginia, and Wyoming, where reliable specimens figures are available with a complete time series, we directly report those figures in this field. In Alabama and Idaho where reliable unique people figures are available with a complete time series, we directly report those figures in this field. We are in the process of switching all states over to use directly reported total figures, using a policy of preferring testing encounters, specimens, and people, in that order.
Returns null if no data is available
totalTestResultsIncrease: Field type: integer
New tests
Daily increase in totalTestResults, calculated from the previous day’s value. This calculation includes all the caveats associated with Total tests/totalTestResults, and we recommend against using it at the state/territory level.
Returns null if no data is available
totalTestResultsSource: Field type: string
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.
totalTestsAntibody: Field type: integer
Total antibody tests (specimens)
Total number of completed antibody tests as reported by the state or territory.
Returns null if no data is available
totalTestsAntigen: Field type: integer
Total antigen tests (specimens)
Total number of completed antigen tests, as reported by the state or territory.
Returns null if no data is available
totalTestsPeopleAntibody: Field type: integer
Total antibody tests (people)
The total number of unique people who have been tested at least once via antibody testing as reported by the state or territory.
Returns null if no data is available
totalTestsPeopleAntigen: Field type: integer
Total antigen tests (people)
Total number of unique people who have been tested at least once via antigen testing, as reported by the state or territory.
Returns null if no data is available
totalTestsPeopleViral: Field type: integer
Total PCR tests (people)
Total number of unique people tested at least once via PCR testing, as reported by the state or territory. The count for this metric is incremented up only the first time an individual person is tested and their result is reported. Future tests of the same person will not be added to this count.

In the case where the state only provides negative cases, this field is calculated as the summation of people who tested positive (“Positive Cases (People”) and the number of people who tested negative (“Negative (People or Cases)”). If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
totalTestsViral: Field type: integer
Total PCR tests (specimens)
Total number of PCR tests (or specimens tested) as reported by the state or territory. The count for this metric is incremented up each time a specimen is tested and the result is reported. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly. For states with ambiguous annotations, we have assigned their total tests to this category; these states and territories are identified in the new API field covidTrackingProjectPreferredTotalTestUnits as having “Unclear units.”
Returns null if no data is available

All COVID data for a single state. Use lower-case state codes in the URL.

View data source for Historic values for a single state

JSON format

/v1/states/{state}/daily.json

Example: https://api.covidtracking.com/v1/states/ca/daily.json

CSV format

/v1/states/{state}/daily.csv

Example: https://api.covidtracking.com/v1/states/ca/daily.csv

Fields

checkTimeEt: Field type: string
Deprecated
commercialScore: Field type: integer
Deprecated

Returns null if no data is available
dataQualityGrade: Field type: string
Data Quality Grade
The COVID Tracking Project grade of the completeness of the data reporting by a state. See our State Grades page and our spreadsheet of grade factors for more information.
date: Field type: integer
Date
Date on which data was collected by The COVID Tracking Project.
dateChecked: Field type: string
Deprecated
dateModified: Field type: string
Deprecated, use lastUpdateEt instead
death: Field type: integer
Deaths (confirmed and probable)
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 some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for fatalities, the metric includes only deaths with COVID-19 listed on the death certificate, unless deaths among cases is a more reliable metric in the state.
Returns null if no data is available
deathConfirmed: Field type: integer
Deaths (confirmed)
Total fatalities with confirmed COVID-19 case diagnosis (per the expanded CSTE case definition of April 5th, 2020 approved by the CDC). In some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for confirmed fatalities, the metric includes only lab-confirmed deaths with COVID-19 listed on the death certificate, unless deaths among confirmed cases is a more reliable metric in the state.
Returns null if no data is available
deathIncrease: Field type: integer
New deaths
Daily increase in death, calculated from the previous day’s value.
Returns null if no data is available
deathProbable: Field type: integer
Deaths (probable)
Total fatalities with probable COVID-19 case diagnosis (per the expanded CSTE case definition of April 5th, 2020 approved by the CDC). In some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for probable fatalities, the metric includes only probable fatalities with COVID-19 listed on the death certificate, unless deaths among probable cases is a more reliable metric in the state.
Returns null if no data is available
fips: Field type: string
FIPS code
State FIPS code
grade: Field type: string
Deprecated
hash: Field type: string
Deprecated - A hash of the current record.
hospitalized: Field type: integer
Deprecated

Returns null if no data is available
hospitalizedCumulative: Field type: integer
Cumulative hospitalized/Ever hospitalized
Total number of individuals who have ever been hospitalized with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients hospitalized with confirmed or suspected COVID-19 cases.
Returns null if no data is available
hospitalizedCurrently: Field type: integer
Currently hospitalized/Now hospitalized
Individuals who are currently hospitalized with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients hospitalized with confirmed or suspected COVID-19 cases.
Returns null if no data is available
hospitalizedDischarged: Field type: integer
Hospital discharges
The total number of COVID-19 patients discharged from the hospital. Wherever possible, we include patients with confirmed or suspected COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients or patients with suspected COVID-19 are included.
Returns null if no data is available
hospitalizedIncrease: Field type: integer
New total hospitalizations
Daily increase in hospitalizedCumulative, calculated from the previous day’s value.
Returns null if no data is available
inIcuCumulative: Field type: integer
Cumulative in ICU/Ever in ICU
Total number of individuals who have ever been hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients in the ICU with confirmed or suspected COVID-19 cases.
Returns null if no data is available
inIcuCurrently: Field type: integer
Currently in ICU/Now in ICU
Individuals who are currently hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients in the ICU with confirmed or suspected COVID-19 cases.
Returns null if no data is available
lastUpdateEt: Field type: string
Last Update (ET)
Date and time in Eastern time the state or territory last updated the data.
negative: Field type: integer
Negative PCR tests (people)
Total number of unique people with a completed PCR test that returns negative. 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. Due to complex reporting procedures, this number might be mixing units and therefore, at best, it should only be considered an estimate of the number of people with a completed PCR test that return negative.
Returns null if no data is available
negativeIncrease: Field type: integer
Deprecated

Returns null if no data is available
negativeRegularScore: Field type: integer
Deprecated

Returns null if no data is available
negativeScore: Field type: integer
Deprecated

Returns null if no data is available
negativeTestsAntibody: Field type: integer
Negative antibody tests (specimens)
The total number of completed antibody tests that return negative as reported by the state or territory.
Returns null if no data is available
negativeTestsPeopleAntibody: Field type: integer
Negative antibody tests (people)
The total number of unique people with completed antibody tests that return negative as reported by the state or territory.
Returns null if no data is available
negativeTestsViral: Field type: integer
Negative PCR tests (specimens)
Total number of completed PCR tests (or specimens tested) that return negative as reported by the state or territory. 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. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
onVentilatorCumulative: Field type: integer
Cumulative on ventilator/Ever on ventilator
Total number of individuals who have ever been hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients on ventilation with confirmed or suspected COVID-19 cases.
Returns null if no data is available
onVentilatorCurrently: Field type: integer
Currently on ventilator/Now on ventilator
Individuals who are currently hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients on ventilation with confirmed or suspected COVID-19 cases.
Returns null if no data is available
pending: Field type: integer
Pending
Total number of viral tests that have not been completed as reported by the state or territory.
Returns null if no data is available
posNeg: Field type: integer
Deprecated

Returns null if no data is available
positive: Field type: integer
Cases (confirmed plus probable)
Total number of confirmed plus probable cases of COVID-19 reported by the state or territory, ideally per the August 5, 2020 CSTE case definition. Some states are following the older April 5th, 2020 CSTE case definition or using their own custom definitions. Not all states and territories report probable cases. If a state is not reporting probable cases, this field will just represent confirmed cases.
Returns null if no data is available
positiveCasesViral: Field type: integer
Confirmed Cases
Total number of unique people with a positive PCR or other approved nucleic acid amplification test (NAAT), as reported by the state or territory. This is equivalent to a confirmed case as per the CSTE case definitions of August 5th, 2020 and April 5th, 2020. If we discover a jurisdiction is labeling cases as confirmed using other evidence (e.g. positive antigen tests), we will annotate that state or territory’s data accordingly.
Returns null if no data is available
positiveIncrease: Field type: integer
New cases
The daily increase in API field positive, which measures Cases (confirmed plus probable) calculated based on the previous day’s value.
Returns null if no data is available
positiveScore: Field type: integer
Deprecated

Returns null if no data is available
positiveTestsAntibody: Field type: integer
Positive antibody tests (specimens)
Total number of completed antibody tests that return positive as reported by the state or territory.
Returns null if no data is available
positiveTestsAntigen: Field type: integer
Positive antigen tests (specimens)
Total number of completed antigen tests that return positive as reported by the state or territory.
Returns null if no data is available
positiveTestsPeopleAntibody: Field type: integer
Positive antibody tests (people)
The total number of unique people with completed antibody tests that return positive as reported by the state or territory.
Returns null if no data is available
positiveTestsPeopleAntigen: Field type: integer
Positive antigen tests (people)
Total number of unique people with a completed antigen test that returned positive as reported by the state or territory.
Returns null if no data is available
positiveTestsViral: Field type: integer
Positive PCR tests (specimens)
Total number of completed PCR tests (or specimens tested) that return positive as reported by the state or territory. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
probableCases: Field type: integer
Probable Cases
Total number of probable cases of COVID-19 as reported by the state or territory, ideally per the August 5, 2020 CSTE case definition. By this definition, a probable case is someone who tests positive via antigen without a positive PCR or other approved nucleic acid amplification test (NAAT), someone with clinical and epidemiological evidence of COVID-19 infection with no confirmatory laboratory testing performed for SARS-CoV-2, or someone with COVID-19 listed on their death certificate with no confirmatory laboratory testing performed for SARS-CoV-2. Some states are following the older April 5th, 2020 CSTE case definition or using their own custom definitions.
Returns null if no data is available
recovered: Field type: integer
Recovered
Total number of people that are identified as recovered from COVID-19. States provide very disparate definitions on what constitutes a “recovered” COVID-19 case. Types of “recovered” cases include those who are discharged from hospitals, released from isolation after meeting CDC guidance on symptoms cessation, or those who have not been identified as fatalities after a number of days (30 or more) post disease onset. Specifics vary for each state or territory.
Returns null if no data is available
score: Field type: integer
Deprecated

Returns null if no data is available
state: Field type: string
State (or territory)
Two-letter abbreviation for the state or territory.
total: Field type: integer
Deprecated

Returns null if no data is available
totalTestEncountersViral: Field type: integer
Total PCR tests (test encounters)
Total number of people tested per day via PCR testing as reported by the state or territory. The count for this metric is incremented up by one for each day on which an individual person is tested, no matter how many specimens are collected from that person on that day. If an individual person is tested twice a day on three different days, this count will increment up by three. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
totalTestResults: Field type: integer
Total test results
At the national level, this metric is a summary statistic which, because of the variation in test reporting methods, is at best an estimate of US viral (PCR) testing. Some states/territories report tests in units of test encounters, some report tests in units of specimens, and some report tests in units of unique people. Moreover, some jurisdictions include antigen tests in their total test counts without reporting a separate total of viral (PCR) tests. Therefore, this value is an aggregate calculation of heterogeneous figures. Please consult each state or territory’s individual data page to see whether that jurisdiction lumps antigen and PCR tests together and to see what units that jurisdiction uses for test reporting.

In most states, the totalTestResults field is currently computed by adding positive and negative values because, historically, some states do not report totals, and to work around different reporting cadences for cases and tests. In Colorado, Delaware, the District of Columbia, Florida, Hawaii, Minnesota, Nevada, New York, North Dakota, Pennsylvania, Rhode Island, Virginia, Washington, and Wisconsin, where reliable testing encounters figures are available with a complete time series, we directly report those figures in this field. In Alaska, America Samoa, Arizona, Arkansas, California, Connecticut, Georgia, Illinois, Indiana, Kentucky, Maine, Maryland, Massachusetts, Michigan, Missouri, Montana, Nebraska, New Hampshire, New Mexico, North Carolina, Ohio, Oregon, South Dakota, Tennessee, Texas, Utah, Vermont, West Virginia, and Wyoming, where reliable specimens figures are available with a complete time series, we directly report those figures in this field. In Alabama and Idaho where reliable unique people figures are available with a complete time series, we directly report those figures in this field. We are in the process of switching all states over to use directly reported total figures, using a policy of preferring testing encounters, specimens, and people, in that order.
Returns null if no data is available
totalTestResultsIncrease: Field type: integer
New tests
Daily increase in totalTestResults, calculated from the previous day’s value. This calculation includes all the caveats associated with Total tests/totalTestResults, and we recommend against using it at the state/territory level.
Returns null if no data is available
totalTestResultsSource: Field type: string
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.
totalTestsAntibody: Field type: integer
Total antibody tests (specimens)
Total number of completed antibody tests as reported by the state or territory.
Returns null if no data is available
totalTestsAntigen: Field type: integer
Total antigen tests (specimens)
Total number of completed antigen tests, as reported by the state or territory.
Returns null if no data is available
totalTestsPeopleAntibody: Field type: integer
Total antibody tests (people)
The total number of unique people who have been tested at least once via antibody testing as reported by the state or territory.
Returns null if no data is available
totalTestsPeopleAntigen: Field type: integer
Total antigen tests (people)
Total number of unique people who have been tested at least once via antigen testing, as reported by the state or territory.
Returns null if no data is available
totalTestsPeopleViral: Field type: integer
Total PCR tests (people)
Total number of unique people tested at least once via PCR testing, as reported by the state or territory. The count for this metric is incremented up only the first time an individual person is tested and their result is reported. Future tests of the same person will not be added to this count.

In the case where the state only provides negative cases, this field is calculated as the summation of people who tested positive (“Positive Cases (People”) and the number of people who tested negative (“Negative (People or Cases)”). If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
totalTestsViral: Field type: integer
Total PCR tests (specimens)
Total number of PCR tests (or specimens tested) as reported by the state or territory. The count for this metric is incremented up each time a specimen is tested and the result is reported. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly. For states with ambiguous annotations, we have assigned their total tests to this category; these states and territories are identified in the new API field covidTrackingProjectPreferredTotalTestUnits as having “Unclear units.”
Returns null if no data is available

All COVID values for a single state on a specific date. Use lower-case state codes in the URL.

View data source for Values for a single state on a specific date

JSON format

/v1/states/{state}/{date}.json

Example: https://api.covidtracking.com/v1/states/ca/20200501.json

CSV format

/v1/states/{state}/{date}.csv

Example: https://api.covidtracking.com/v1/states/ca/20200501.csv

Fields

checkTimeEt: Field type: string
Deprecated
commercialScore: Field type: integer
Deprecated

Returns null if no data is available
dataQualityGrade: Field type: string
Data Quality Grade
The COVID Tracking Project grade of the completeness of the data reporting by a state. See our State Grades page and our spreadsheet of grade factors for more information.
date: Field type: integer
Date
Date on which data was collected by The COVID Tracking Project.
dateChecked: Field type: string
Deprecated
dateModified: Field type: string
Deprecated, use lastUpdateEt instead
death: Field type: integer
Deaths (confirmed and probable)
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 some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for fatalities, the metric includes only deaths with COVID-19 listed on the death certificate, unless deaths among cases is a more reliable metric in the state.
Returns null if no data is available
deathConfirmed: Field type: integer
Deaths (confirmed)
Total fatalities with confirmed COVID-19 case diagnosis (per the expanded CSTE case definition of April 5th, 2020 approved by the CDC). In some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for confirmed fatalities, the metric includes only lab-confirmed deaths with COVID-19 listed on the death certificate, unless deaths among confirmed cases is a more reliable metric in the state.
Returns null if no data is available
deathIncrease: Field type: integer
New deaths
Daily increase in death, calculated from the previous day’s value.
Returns null if no data is available
deathProbable: Field type: integer
Deaths (probable)
Total fatalities with probable COVID-19 case diagnosis (per the expanded CSTE case definition of April 5th, 2020 approved by the CDC). In some states, these individuals must also have COVID-19 listed on the death certificate to count as a COVID-19 death. When states post multiple numbers for probable fatalities, the metric includes only probable fatalities with COVID-19 listed on the death certificate, unless deaths among probable cases is a more reliable metric in the state.
Returns null if no data is available
fips: Field type: string
FIPS code
State FIPS code
grade: Field type: string
Deprecated
hash: Field type: string
Deprecated - A hash of the current record.
hospitalized: Field type: integer
Deprecated

Returns null if no data is available
hospitalizedCumulative: Field type: integer
Cumulative hospitalized/Ever hospitalized
Total number of individuals who have ever been hospitalized with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients hospitalized with confirmed or suspected COVID-19 cases.
Returns null if no data is available
hospitalizedCurrently: Field type: integer
Currently hospitalized/Now hospitalized
Individuals who are currently hospitalized with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients hospitalized with confirmed or suspected COVID-19 cases.
Returns null if no data is available
hospitalizedDischarged: Field type: integer
Hospital discharges
The total number of COVID-19 patients discharged from the hospital. Wherever possible, we include patients with confirmed or suspected COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients or patients with suspected COVID-19 are included.
Returns null if no data is available
hospitalizedIncrease: Field type: integer
New total hospitalizations
Daily increase in hospitalizedCumulative, calculated from the previous day’s value.
Returns null if no data is available
inIcuCumulative: Field type: integer
Cumulative in ICU/Ever in ICU
Total number of individuals who have ever been hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients in the ICU with confirmed or suspected COVID-19 cases.
Returns null if no data is available
inIcuCurrently: Field type: integer
Currently in ICU/Now in ICU
Individuals who are currently hospitalized in the Intensive Care Unit with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients in the ICU with confirmed or suspected COVID-19 cases.
Returns null if no data is available
lastUpdateEt: Field type: string
Last Update (ET)
Date and time in Eastern time the state or territory last updated the data.
negative: Field type: integer
Negative PCR tests (people)
Total number of unique people with a completed PCR test that returns negative. 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. Due to complex reporting procedures, this number might be mixing units and therefore, at best, it should only be considered an estimate of the number of people with a completed PCR test that return negative.
Returns null if no data is available
negativeIncrease: Field type: integer
Deprecated

Returns null if no data is available
negativeRegularScore: Field type: integer
Deprecated

Returns null if no data is available
negativeScore: Field type: integer
Deprecated

Returns null if no data is available
negativeTestsAntibody: Field type: integer
Negative antibody tests (specimens)
The total number of completed antibody tests that return negative as reported by the state or territory.
Returns null if no data is available
negativeTestsPeopleAntibody: Field type: integer
Negative antibody tests (people)
The total number of unique people with completed antibody tests that return negative as reported by the state or territory.
Returns null if no data is available
negativeTestsViral: Field type: integer
Negative PCR tests (specimens)
Total number of completed PCR tests (or specimens tested) that return negative as reported by the state or territory. 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. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
onVentilatorCumulative: Field type: integer
Cumulative on ventilator/Ever on ventilator
Total number of individuals who have ever been hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients on ventilation with confirmed or suspected COVID-19 cases.
Returns null if no data is available
onVentilatorCurrently: Field type: integer
Currently on ventilator/Now on ventilator
Individuals who are currently hospitalized under advanced ventilation with COVID-19. Definitions vary by state / territory, and it is not always clear whether pediatric patients are included in this metric. Where possible, we report patients on ventilation with confirmed or suspected COVID-19 cases.
Returns null if no data is available
pending: Field type: integer
Pending
Total number of viral tests that have not been completed as reported by the state or territory.
Returns null if no data is available
posNeg: Field type: integer
Deprecated

Returns null if no data is available
positive: Field type: integer
Cases (confirmed plus probable)
Total number of confirmed plus probable cases of COVID-19 reported by the state or territory, ideally per the August 5, 2020 CSTE case definition. Some states are following the older April 5th, 2020 CSTE case definition or using their own custom definitions. Not all states and territories report probable cases. If a state is not reporting probable cases, this field will just represent confirmed cases.
Returns null if no data is available
positiveCasesViral: Field type: integer
Confirmed Cases
Total number of unique people with a positive PCR or other approved nucleic acid amplification test (NAAT), as reported by the state or territory. This is equivalent to a confirmed case as per the CSTE case definitions of August 5th, 2020 and April 5th, 2020. If we discover a jurisdiction is labeling cases as confirmed using other evidence (e.g. positive antigen tests), we will annotate that state or territory’s data accordingly.
Returns null if no data is available
positiveIncrease: Field type: integer
New cases
The daily increase in API field positive, which measures Cases (confirmed plus probable) calculated based on the previous day’s value.
Returns null if no data is available
positiveScore: Field type: integer
Deprecated

Returns null if no data is available
positiveTestsAntibody: Field type: integer
Positive antibody tests (specimens)
Total number of completed antibody tests that return positive as reported by the state or territory.
Returns null if no data is available
positiveTestsAntigen: Field type: integer
Positive antigen tests (specimens)
Total number of completed antigen tests that return positive as reported by the state or territory.
Returns null if no data is available
positiveTestsPeopleAntibody: Field type: integer
Positive antibody tests (people)
The total number of unique people with completed antibody tests that return positive as reported by the state or territory.
Returns null if no data is available
positiveTestsPeopleAntigen: Field type: integer
Positive antigen tests (people)
Total number of unique people with a completed antigen test that returned positive as reported by the state or territory.
Returns null if no data is available
positiveTestsViral: Field type: integer
Positive PCR tests (specimens)
Total number of completed PCR tests (or specimens tested) that return positive as reported by the state or territory. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
probableCases: Field type: integer
Probable Cases
Total number of probable cases of COVID-19 as reported by the state or territory, ideally per the August 5, 2020 CSTE case definition. By this definition, a probable case is someone who tests positive via antigen without a positive PCR or other approved nucleic acid amplification test (NAAT), someone with clinical and epidemiological evidence of COVID-19 infection with no confirmatory laboratory testing performed for SARS-CoV-2, or someone with COVID-19 listed on their death certificate with no confirmatory laboratory testing performed for SARS-CoV-2. Some states are following the older April 5th, 2020 CSTE case definition or using their own custom definitions.
Returns null if no data is available
recovered: Field type: integer
Recovered
Total number of people that are identified as recovered from COVID-19. States provide very disparate definitions on what constitutes a “recovered” COVID-19 case. Types of “recovered” cases include those who are discharged from hospitals, released from isolation after meeting CDC guidance on symptoms cessation, or those who have not been identified as fatalities after a number of days (30 or more) post disease onset. Specifics vary for each state or territory.
Returns null if no data is available
score: Field type: integer
Deprecated

Returns null if no data is available
state: Field type: string
State (or territory)
Two-letter abbreviation for the state or territory.
total: Field type: integer
Deprecated

Returns null if no data is available
totalTestEncountersViral: Field type: integer
Total PCR tests (test encounters)
Total number of people tested per day via PCR testing as reported by the state or territory. The count for this metric is incremented up by one for each day on which an individual person is tested, no matter how many specimens are collected from that person on that day. If an individual person is tested twice a day on three different days, this count will increment up by three. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
totalTestResults: Field type: integer
Total test results
At the national level, this metric is a summary statistic which, because of the variation in test reporting methods, is at best an estimate of US viral (PCR) testing. Some states/territories report tests in units of test encounters, some report tests in units of specimens, and some report tests in units of unique people. Moreover, some jurisdictions include antigen tests in their total test counts without reporting a separate total of viral (PCR) tests. Therefore, this value is an aggregate calculation of heterogeneous figures. Please consult each state or territory’s individual data page to see whether that jurisdiction lumps antigen and PCR tests together and to see what units that jurisdiction uses for test reporting.

In most states, the totalTestResults field is currently computed by adding positive and negative values because, historically, some states do not report totals, and to work around different reporting cadences for cases and tests. In Colorado, Delaware, the District of Columbia, Florida, Hawaii, Minnesota, Nevada, New York, North Dakota, Pennsylvania, Rhode Island, Virginia, Washington, and Wisconsin, where reliable testing encounters figures are available with a complete time series, we directly report those figures in this field. In Alaska, America Samoa, Arizona, Arkansas, California, Connecticut, Georgia, Illinois, Indiana, Kentucky, Maine, Maryland, Massachusetts, Michigan, Missouri, Montana, Nebraska, New Hampshire, New Mexico, North Carolina, Ohio, Oregon, South Dakota, Tennessee, Texas, Utah, Vermont, West Virginia, and Wyoming, where reliable specimens figures are available with a complete time series, we directly report those figures in this field. In Alabama and Idaho where reliable unique people figures are available with a complete time series, we directly report those figures in this field. We are in the process of switching all states over to use directly reported total figures, using a policy of preferring testing encounters, specimens, and people, in that order.
Returns null if no data is available
totalTestResultsIncrease: Field type: integer
New tests
Daily increase in totalTestResults, calculated from the previous day’s value. This calculation includes all the caveats associated with Total tests/totalTestResults, and we recommend against using it at the state/territory level.
Returns null if no data is available
totalTestResultsSource: Field type: string
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.
totalTestsAntibody: Field type: integer
Total antibody tests (specimens)
Total number of completed antibody tests as reported by the state or territory.
Returns null if no data is available
totalTestsAntigen: Field type: integer
Total antigen tests (specimens)
Total number of completed antigen tests, as reported by the state or territory.
Returns null if no data is available
totalTestsPeopleAntibody: Field type: integer
Total antibody tests (people)
The total number of unique people who have been tested at least once via antibody testing as reported by the state or territory.
Returns null if no data is available
totalTestsPeopleAntigen: Field type: integer
Total antigen tests (people)
Total number of unique people who have been tested at least once via antigen testing, as reported by the state or territory.
Returns null if no data is available
totalTestsPeopleViral: Field type: integer
Total PCR tests (people)
Total number of unique people tested at least once via PCR testing, as reported by the state or territory. The count for this metric is incremented up only the first time an individual person is tested and their result is reported. Future tests of the same person will not be added to this count.

In the case where the state only provides negative cases, this field is calculated as the summation of people who tested positive (“Positive Cases (People”) and the number of people who tested negative (“Negative (People or Cases)”). If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly.
Returns null if no data is available
totalTestsViral: Field type: integer
Total PCR tests (specimens)
Total number of PCR tests (or specimens tested) as reported by the state or territory. The count for this metric is incremented up each time a specimen is tested and the result is reported. If we discover that a jurisdiction is including antigen tests in this metric, we will annotate that state or territory’s data accordingly. For states with ambiguous annotations, we have assigned their total tests to this category; these states and territories are identified in the new API field covidTrackingProjectPreferredTotalTestUnits as having “Unclear units.”
Returns null if no data is available

API domain name

US Current and Historical Data

Historic US values ↓

JSON format

CSV format

Fields

Current US values ↓

JSON format

CSV format

Fields

US historic values for a date ↓

JSON format

CSV format

Fields

States Current and Historical Data

State metadata ↓

JSON format

CSV format

Fields

Metadata about a specific state ↓

JSON format

CSV format

Fields

Historic values for all states ↓

JSON format

CSV format

Fields

Current values for all states ↓

JSON format

CSV format

Fields

Current values for a single state ↓

JSON format

CSV format

Fields

Historic values for a single state ↓

JSON format

CSV format

Fields

Values for a single state on a specific date ↓

JSON format

CSV format

Fields

Status

API status ↓

JSON format

CSV format

Fields

Historic US values

Current US values

US historic values for a date

State metadata

Metadata about a specific state

Historic values for all states

Current values for all states

Current values for a single state

Historic values for a single state

Values for a single state on a specific date

API status