{"uid":"cap_3_pdd9DPXFu8kHxd2rBQ7","slug":"2s-io-cdc-mortality-statistics-08a92d0c","name":"2s.io CDC Mortality Statistics","description":"US mortality statistics from CDC NCHS. dataset=leading-causes (default): annual deaths + age-adjusted death rate per 100k by state and top-10 cause of death, 1999-2017 — filter by state (full name, e.g. \"California\", or \"United States\"), year, cause (e.g. \"Heart disease\", \"Cancer\", \"Suicide\"). dataset=weekly-counts: provisional weekly death counts by jurisdiction with per-cause columns (all-cause, natural, COVID-19, heart disease, cancer, etc.), 2020-2023 — filter by state and mmwrYear. Rows returned raw from CDC with documented column names. Public-domain federal data.","url":"https://2s.io/api/health/mortality-stats","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"properties":{"year":{"type":"integer","maximum":2023,"minimum":1999},"cause":{"type":"string","description":"leading-causes only. E.g. \"Heart disease\", \"Cancer\", \"Suicide\", \"All causes\"."},"limit":{"type":"integer","default":25,"maximum":200,"minimum":1},"state":{"type":"string","description":"Full state name (\"California\") or \"United States\"."},"offset":{"type":"integer","default":0,"minimum":0},"dataset":{"enum":["leading-causes","weekly-counts"],"type":"string","default":"leading-causes"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"year":2015,"cause":"Heart disease","limit":25,"state":"California","offset":0,"dataset":"leading-causes"}}},"response":{"data":{"ok":true,"meta":{"dataset":"leading-causes"},"items":[{"aadr":"145.6","year":"2015","state":"California","deaths":"61289","cause_name":"Heart disease","_113_cause_name":"Diseases of heart (I00-I09,I11,I13,I20-I51)"}],"total":null,"source":{"url":"https://data.cdc.gov/","license":"Public domain (US government records)","provider":"CDC National Center for Health Statistics"}},"meta":{"cost":{"usd":0.0024,"tier":0},"caller":"x402","version":null,"endpoint":"health.mortality-stats","settlement":{"txHash":"0x7e091a38bf2bb4cc808e62d8bf14e5bb51412cb4139d54f8d5f449a90c92a06b","network":"eip155:8453","success":true}}}},"exampleRequest":{"year":2015,"cause":"Heart disease","limit":25,"state":"California","offset":0,"dataset":"leading-causes"},"tags":["x402"],"displayCostAmount":"0.0024","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0024/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RVI8BLuiWtZMVJY4LlbaW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns US mortality data from CDC NCHS — either annual leading-cause death counts and age-adjusted rates by state (1999–2017) or provisional weekly death counts by jurisdiction (2020–2023)","exampleAgentPrompt":"Pull me the CDC leading-causes mortality data for California, filtering for Heart disease deaths in 2015 — I want the annual death count and age-adjusted death rate per 100k.","exampleUseCases":null,"resultDescription":"Raw rows from the CDC NCHS dataset with documented column names. For leading-causes: state, year, cause of death, number of deaths, and age-adjusted death rate per 100,000 population. For weekly-counts: jurisdiction, MMWR year/week, and per-cause columns including all-cause, natural causes, COVID-19, heart disease, cancer, and more.","failureModes":["Invalid state name (must be full name like 'California', not abbreviation 'CA') returns no results or error","Year out of range for dataset (leading-causes: 1999–2017; weekly-counts: 2020–2023) returns empty result set","Cause string mismatch (case-sensitive or typo) returns no matching rows","Offset beyond available data returns empty rows array","Upstream CDC data unavailability causes 5xx or timeout"],"whenToPreferThis":"Choose this endpoint when you need official US mortality statistics from CDC NCHS — either historical annual leading-cause death data by state (1999–2017) or provisional weekly death counts including COVID-19 (2020–2023). Prefer this over general web search when you need structured, queryable, public-domain federal mortality data with consistent column schemas. Best for epidemiological analysis, public health research, or trend comparisons by state and cause.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":7,"lastUsedAt":"2026-07-19T00:15:21.580Z","lastSuccessfullyRanAt":"2026-07-19T00:15:21.580Z","lastHealthCheckAt":"2026-09-14T06:58:44.706Z","isFirstParty":false}