latestOpenAPI 3.0.02026-08-0811452.3 KB

d8c8699063a9

States Current and Historical Data

State metadata

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

get/v1/states/info.{format}

Path parameters

formatstring required
Example:json

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

Response

OK

statestring

The state postal code

notesstring nullable

Notes about the state

covid19Sitestring nullable

URL to the state's COVID website

covid19SiteSecondarystring nullable

URL to the state's secondary COVID website

covid19SiteTertiarystring nullable

URL to the state's third COVID website

covid19SiteQuaternarystring nullable

URL to the state's fourth COVID website

covid19SiteQuinarystring nullable

URL to the state's fifth COVID website

twitterstring nullable

The state's COVID-related Twitter handle

covid19SiteOldstring nullable

URL to the state's old COVID website

covidTrackingProjectPreferredTotalTestUnitsstring nullable

Preferred units to use for total test results.

covidTrackingProjectPreferredTotalTestFieldstring nullable

Preferred field to use for total test results.

totalTestResultsFieldstring nullable

Source field for total test results.

namestring

The name of the state

fipsstring

The census FIPS code

puistring nullable

Deprecated

pumboolean nullable

Deprecated

Example response

[
  {
    "state": "CA",
    "notes": "This state reports data correctly.",
    "covid19Site": "http://dhss.alaska.gov/dph/Epi/id/Pages/COVID-19/default.asp",
    "covid19SiteSecondary": "http://dhss.alaska.gov/dph/Epi/id/Pages/COVID-19/default.asp",
    "covid19SiteTertiary": "http://dhss.alaska.gov/dph/Epi/id/Pages/COVID-19/default.asp",
    "covid19SiteQuaternary": "http://dhss.alaska.gov/dph/Epi/id/Pages/COVID-19/default.asp",
    "covid19SiteQuinary": "http://dhss.alaska.gov/dph/Epi/id/Pages/COVID-19/default.asp",
    "twitter": "@Alaska_DHSS",
    "covid19SiteOld": "http://dhss.alaska.gov/dph/Epi/id/Pages/COVID-19/default.asp",
    "name": "California",
    "fips": "09"
  }
]