# MilitarySpend.org open data

Machine-readable exports of the datasets behind MilitarySpend.org's trackers and
research pages. Each dataset ships as a matching `.csv` and `.json` pair. Files
are regenerated at build time from the site's source configs by
`scripts/generate-datasets.mjs` — do not edit them by hand.

## Datasets

### iran-war-casualties
Casualty ranges for Operation Epic Fury by side and category (US, Iran, Lebanon,
and civilian groups), with a low/high estimate, the date last verified, a
confidence flag, and the primary source name and URL.

### iran-war-equipment-losses
US equipment attrition line items — aircraft, radars, and other assets — with
unit count, unit cost, and total cost in USD.

### iran-war-timeline
Chronological milestones of the US-Iran war (Operation Epic Fury) with a date,
short title, and description.

### iran-war-cost-phases
The phased daily-cost model and the category cost breakdown in one file, keyed by
`record_type` (`phase` or `breakdown`). Phases carry an `end_day` cutoff and a
daily cost; breakdown rows carry a category daily cost plus description.

### iran-ceasefire-events
Status-changing events for the Pakistan-brokered April 8, 2026 ceasefire, each
tagged with an `impact` classification (strengthening / weakening / neutral) and
a source name and URL.

### military-spending-by-country-2026
Top military spenders for 2026 (SIPRI 2025 actuals) with rank, ISO code, total
spend, share of GDP, per-capita spend, year-over-year change, and an editorial
note.

### military-spending-per-capita-2026
Military spending per capita for 2026 by country, with total spend, population,
rank by total spend, and share of GDP.

### us-states-defense
Headline defense-economy metrics for each US state: population, DoD contract
dollars (FY2025), active-duty personnel, installation count and names, per-capita
defense spending, and rank fields.

### iran-war-snapshot.json
A single hand-curated JSON snapshot of headline Iran-war figures (war cost model,
casualty ranges, ceasefire status), regenerated from live config values.

## License

CC-BY 4.0 — attribution required: 'MilitarySpend.org, https://militaryspend.org/data'

## Update cadence

The Iran-war datasets (casualties, equipment, timeline, cost phases, ceasefire
events, snapshot) are refreshed daily as the underlying trackers change. The
military-spending datasets refresh with each annual SIPRI/data vintage, and the
US states dataset refreshes on its periodic data-review cycle. All files are
rebuilt on every site deploy.
