health

US mortality statistics from CDC NCHS.

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.

get/api/health/mortality-stats

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/health/mortality-stats
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

dataset'leading-causes' | 'weekly-counts'

Dataset.

statestring

US state — two-letter postal abbreviation (e.g. CA) or full name.

yearinteger

Four-digit calendar year.

causestring

Cause.

limitinteger

Maximum number of results to return.

offsetinteger

Number of results to skip before returning (pagination offset).

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.