# Source snapshot: us-falls-vs-homicide-2024

[`fetch.mjs`](fetch.mjs) queried CDC WONDER on **20 November 2026** (from the package folder: `npm install && node us-falls-vs-homicide-2024-src/fetch.mjs`, about two minutes; WONDER asks for 15 seconds between requests). [`extract-life-table.py`](extract-life-table.py) extracts life expectancy from the NCHS life table. [`calculate.mjs`](calculate.mjs) checks the SHA-256 of both extracts and writes every number in the post to `statistics.json`.

## CDC WONDER, Underlying Cause of Death (public domain)

- **Publisher:** Centers for Disease Control and Prevention, National Center for Health Statistics. *Underlying Cause of Death, 2018–2024, Single Race* (database D158, <https://wonder.cdc.gov/ucd-icd10-expanded.html>) and *Underlying Cause of Death, 1999–2020* (D76, <https://wonder.cdc.gov/ucd-icd10.html>). Final data from the National Vital Statistics System, compiled from data provided by the 57 vital statistics jurisdictions through the Vital Statistics Cooperative Program. US residents only. API endpoint: `https://wonder.cdc.gov/controller/datarequest/D158` (and `/D76`), XML request built from each database's own request form.
- **Causes:** the NCHS 113 cause list (variable V4), underlying cause of death:
  - `GR113-118` "Falls (W00–W19)", under "Accidents (unintentional injuries)": unintentional falls.
  - `GR113-127` "#Assault (homicide) (*U01–*U02, X85–Y09, Y87.1)": the NCHS rankable homicide category, including terrorism homicides (*U01–*U02) and sequelae of assault (Y87.1). This is the definition behind CDC FastStats' homicide figure.
- **Queries:** cause × year (D158 2018–2024; D76 1999–2020, of which 1999–2017 are used and 2018–2020 checked against D158: identical); cause × five-year age group, 2024, ages 15–84; cause, 2024, ages 85+ merged. Deaths, population (the Census Bureau estimates WONDER supplies) and crude rate per 100,000.
- **Licence and terms:** US federal government data, public domain. WONDER's data-use restrictions (accepted with `accept_datause_restrictions=true`) forbid identifying individuals and publishing statistics for 1–9 deaths ([data-use restrictions](https://wonder.cdc.gov/datause.html)). Two 2024 cells are suppressed: falls under age 1, and homicide with age not stated. This package does not fetch ages 0–14 or "not stated"; `calculate.mjs` derives only their combined remainder (total minus ages 15+), which splits neither cell out from the package's own data. (WONDER itself publishes the 1–4 and 5–14 groups, so anyone combining WONDER's own tables can do the same subtraction; we add nothing to that.) `fetch.mjs` stops if any kept cell is suppressed or below 10; the smallest kept cell is 43.
- **Citation:** Centers for Disease Control and Prevention, National Center for Health Statistics. National Vital Statistics System, Mortality 2018–2024 on CDC WONDER Online Database. Accessed 20 November 2026.
- **Re-fetch (21 November 2026):** the D76 query was re-run keeping 1999–2014 as well, for the post's long view; every row for 2015–2024 came back identical to the 20 November extract, and only the raw responses' bytes (and so their hashes) differ. Figures change if NCHS reissues a file, so WONDER responses are not hash-checked; their hashes on this run are in `cdc-wonder-response-hashes.json`. `calculate.mjs` checks the committed CSV.

## Cross-checks against CDC's published figures (fetched 20 November 2026)

- CDC WISQARS, *10 Leading Causes of Injury Deaths by Age Group, United States – 2024*, <https://wisqars.cdc.gov/pdfs/leading-causes-of-injury-deaths-by-age-group_2024_508.pdf> (SHA-256 `69531c628755202003d166485ef37b9b61bd1c3e196d7ee927f8aa4a96fe9170`; not kept): unintentional fall, all ages **48,308**; ages 65+ **43,020**. Both equal this extract.
- CDC NCHS FastStats, *Assault or Homicide*, <https://www.cdc.gov/nchs/fastats/homicide.htm> (last reviewed 29 September 2026): homicides **20,162**, 5.9 per 100,000 (2024, "National Vital Statistics System – Mortality Data (2024) via CDC WONDER"). Equal to this extract (crude rate 5.93).

## NCHS United States Life Tables, 2024 (public domain; sensitivity only)

- **Publisher:** NCHS, *United States Life Tables, 2024*, National Vital Statistics Reports vol. 75 no. 5, Table 1 "Life table for the total population: United States, 2024". File: <https://ftp.cdc.gov/pub/Health_Statistics/NCHS/Publications/NVSR/75-05/Table01.xlsx>, retrieved 20 November 2026, kept as `nchs-us-life-table-2024-table01.xlsx`. Life expectancy at birth 78.97 years.
- **Used for:** remaining life expectancy (ex) at each age group's midpoint, for the years-of-life-lost check in NOTES.md.

## Files

Uploaded with the post: `statistics.json` and the scripts. The extracts and the workbook below stay in the repository (`../.datahubignore`): `fetch.mjs` re-queries WONDER and `extract-life-table.py` rebuilds the life-table extract from the NCHS file, after which `calculate.mjs` reproduces `statistics.json`.


| File | Bytes | SHA-256 |
|---|---|---|
| `cdc-wonder-falls-homicide.csv` (88 rows: query, database, label, vintage, cause, code, group, deaths, population, crude rate) | 9,777 | `25c808ff2a72b8af27f51e8ef4463096e7e1f2dae64ade9cbb441f97750f3c75` |
| `cdc-wonder-response-hashes.json` (hash of each raw WONDER response) | 647 | `e0ba56c7ea7043ecab9e48d5b0a41b72e5c80b0315e5bff81ebc607fca63a7dc` |
| `nchs-us-life-table-2024-table01.xlsx` (as downloaded) | 20,584 | `d9ce5588403433666c26eaf178ed7afd0cd591c65b3b08dcba2b76fcf5dcdd3c` |
| `nchs-us-life-table-2024-ex.csv` (age, ex; 101 rows) | 1,793 | `b6f298518f68db7153ce904da5faf9cb81a06802a3ac6a052987b9779b227295` |
