Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/states

US states (all, or one)

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/disease-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/disease-api/v1/states" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/disease-api/v1/states", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/disease-api/v1/states");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/disease-api/v1/states",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "count": 63,
        "states": [
            {
                "cases": 12711918,
                "state": "California",
                "deaths": 112443,
                "updated": 1780881454275,
                "recovered": 0,
                "population": 39512223,
                "cases_per_million": 321721,
                "deaths_per_million": 2846
            },
            {
                "cases": 9190299,
                "state": "Texas",
                "deaths": 104793,
                "updated": 1780881454275,
                "recovered": 0,
                "population": 28995881,
                "cases_per_million": 316952,
                "deaths_per_million": 3614
            },
            {
                "cases": 8048191,
                "state": "Florida",
                "deaths": 95206,
                "updated": 1780881454275,
                "recovered": 0,
                "population": 21477737,
                "cases_per_million": 374722,
                "deaths_per_million": 4433
            },
            {
                "cases": 7587861,
                "state": "New York",
                "deaths": 83374,
                "updated": 1780881454275,
                "recovered": 0,
                "population": 19453561,
                "cases_per_million": 390050,
                "deaths_per_million": 4286
            },
            {
                "cases": 4136659,
                "state": "Illinois",
                "deaths": 42005,
                "updated": 1780881454275,
                "recovered": 0,
                "population": 12671821,
                "cases_per_million": 326446,
                "deaths_per_million": 3315
            },
            {
                "cases": 3741277,
                "state": "Ohio",
                "deaths": 43896,
                "updated": 1780881454275,
                "recovered": 3684603,
                "population": 11689100,
                "cases_per_million": 320065,
                "deaths_per_million": 3755
            },
            {
                "cases": 3565499,
                "state": "Pennsylvania",
                "deaths": 51480,
                "updated": 1780881454275,
                "recovered": 0,
                "population": 12801989,
                "cases_per_million": 278511,
                "deaths_per_million": 4021
            },
            {
                "cases": 3501404,
                "state": "North Carolina",
                "deaths": 29059,
                "updated": 1780881454275,
                "recovered": 0,
                "population": 10488084,
                "cases_per_million": 333846,
                "deaths_per_million": 2771
            },
            {
                "cases": 3306221,
                "state": "Michigan",
                "deaths": 44762,
                "updated": 1780881454276,
                "recovered": 0,
                "population": 9986857,
                "ca
…