Version 2 of our data API is built to solve several problems with ensuring the accuracy of data, and putting that data into context. It adds several new features:
- Data is now delivered in JSON objects that contain data and metadata
- Every endpoint includes field definitions and titles for all data
- Every field includes common equations like percentage of population, or percent increase over 7 days, where appropriate.
- Additional “simplified” endpoints to lower file-size
| V1 name | V2 name | Description |
|---|---|---|
covidTrackingProjectPreferredTotalTestField | covid_tracking_project.preferred_total_test.field | COVID Tracking Project preferred total test field |
covidTrackingProjectPreferredTotalTestUnits | covid_tracking_project.preferred_total_test.units | COVID Tracking Project preferred total test units |
date | date | Date |
death | outcomes.death.cumulative | Deaths (confirmed and probable) |
deathConfirmed | outcomes.death.confirmed | Deaths (confirmed) |
deathIncrease | outcomes.death.calculated.change_from_prior_day | New deaths |
deathProbable | outcomes.death.probable | Deaths (probable) |
fips | fips | FIPS code |
hospitalizedCumulative | outcomes.hospitalized.total | Cumulative hospitalized/Ever hospitalized |
hospitalizedCurrently | hospitalization.hospitalized.currently | Currently hospitalized/Now hospitalized |
inIcuCumulative | outcomes.hospitalized.in_icu | Cumulative in ICU/Ever in ICU |
inIcuCurrently | hospitalization.in_icu.currently | Currently in ICU/Now in ICU |
lastUpdateEt | meta.updated | Last Update (ET) |
onVentilatorCumulative | hospitalization.on_ventilator.cumulative | Cumulative on ventilator/Ever on ventilator |
onVentilatorCurrently | hospitalization.on_ventilator.currently | Currently on ventilator/Now on ventilator |
positive | cases.total | Cases (confirmed plus probable) |
positiveCasesViral | cases.confirmed | Confirmed Cases |
state | name | State (or territory) |
state_code | state_code | State code |
states | states_count | States |
totalTestResults | tests.pcr.total | Total test results |
National Data
All COVID data for the US.
URL path:/v2/us/daily.json
One day of data for the US.
URL path:/v2/us/daily/[date-iso-format].json
Example: https://api.covidtracking.com/v2/us/daily/2021-01-02.json
Simplified data:/v2/us/daily/[date-iso-format].json
Simplified data example: https://api.covidtracking.com/v2/us/daily/2021-01-02/simple.json
State & Territories Data
Basic information about all states, including notes about our methodology and the websites we use to check for data.
URL path:/v2/states.json
Basic information about all states, including notes about our methodology and the websites we use to check for data.
URL path:/v2/states/[state-code].json
All historic data for a single state
URL path:/v2/states/[state-code]/daily.json
Example: https://api.covidtracking.com/v2/states/ca/daily.json
Simplified data:/v2/states/[state-code]/daily.json
Simplified data example: https://api.covidtracking.com/v2/states/ca/daily/simple.json
Returns data for a single day.
URL path:/v2/states/[state-code]/[date-iso-format].json
Example: https://api.covidtracking.com/v2/states/ca/2021-01-10.json
Simplified data:/v2/states/[state-code]/[date-iso-format].json
Simplified data example: https://api.covidtracking.com/v2/states/ca/2021-01-10/simple.json