Skip to main content

Initial Basic API & CSV Downloads

Accessing the data via JSON or CSV

The default response is JSON using normal GET requests. If you'd like CSV just append .csv at the end of the url. For example https://covidtracking.com/api/states.csv

All data is cumulative, so you should not see any counts going down over time. If you do, please get in touch as it is likely an error. As you might be able to tell from the key names, date time values are in ET.

Please be aware that each state has its own set of caveats, which we have documented on our data page.

The API format will change slightly in the future. Please see fields marked DEPRECATED below.

If you want to filter the /api/states/daily you can add a query param like ?state=NY to only show cases in New York. Or /api/states/daily?state=NY&date=20200316 to show the result of a specific date. Or to access the most recent value /api/states?state=NY.

GraphQL API

Endpoint Details

/api/states - States Current Values

These numbers are updated periodically throughout the day.

/api/states | CSV

/api/states/daily - States Historical Data

Entries saved each day at 4 pm ET.

/api/states/daily | CSV

/api/states/info - States Information

/api/states/info | CSV

/api/us - US Current Values

These numbers are updated periodically throughout the day.

/api/us | CSV

/api/us/daily - US Historical Data

Entries saved each day at 4 pm ET.

/api/us/daily | CSV

/api/urls - Tracker URLs

/api/urls

/api/cdc/daily - CDC Reported Tests

/api/cdc/daily | CSV

The table found on the CDC Testing in U.S. webpage is available via this endpoint. Please visit the CDC to learn more. Source

/api/cdc/daily | CSV