About This Dataset
Methodology, data dictionary, schema reference, and source documentation.
Overview
This dataset is an open-source OSINT (Open Source Intelligence) collection tracking Iranian missile and drone attack waves against Israel and US/coalition targets across two major operations in the 2025–2026 Iran-Israel conflict.
Data is collected from open-source reporting, official military statements, satellite imagery analysis, and verified social media. It is structured in a consistent JSON schema to facilitate analysis, visualization, and cross-referencing.
Operations Covered
True Promise 3 (TP3)
Dates: June 13–24, 2025 (12 days)
Also known as: "Twelve-Day War"
Waves: 22 documented
Estimated munitions: 1,600–1,800+
Israeli interception rate (claimed): 86%
Iran's response to Israeli Operation Rising Lion, which struck Iranian nuclear facilities. Primarily targeted Israeli military infrastructure, air bases, IDF command centers, and critical civilian infrastructure (power plants, refineries). Houthi forces coordinated proxy attacks. Total Israeli casualties: 33 killed, 3,238 wounded.
True Promise 4 (TP4)
Start date: February 28, 2026 (ongoing)
Waves documented: 19+
Countries targeted: 12 (AE, BH, CY, IL, IO, IQ, JO, KW, OM, QA, SA, TR)
Dramatically expanded scope compared to TP3. Targets include US military facilities across the Persian Gulf (USN Fifth Fleet HQ Bahrain, Al-Udeid, Camp Arifjan, etc.), Israeli targets, and commercial shipping. Launched in response to US-Israeli Operation Epic Fury / Roaring Lion strikes. Multi-national coalition defense involving US, UK, France, Jordan, UAE, and others.
Data Dictionary
Each wave record contains the following top-level fields:
| Field | Type | Description |
|---|---|---|
announced_utc | ISO 8601 | IRGC announcement timestamp |
probable_launch_time | ISO 8601 | Estimated actual launch time |
launch_time_israel | ISO 8601+tz | Local time in Israel |
launch_time_iran | ISO 8601+tz | Local time in Iran |
conflict_day | integer | Day within the operation (1-indexed) |
solar_phase_launch_site | 0/1 | 0=night, 1=day at launch site |
hours_since_last_wave | float | null | Time gap since prior wave |
| Field | Type | Description |
|---|---|---|
payload | string | Free-text payload description |
ballistic_missiles_used | boolean | Any ballistic missile type fired |
cruise_missiles_used | boolean | Any cruise missile type fired |
drones_used | boolean | Any drone type fired |
types.emad_used | boolean | null | Emad liquid-fuel MRBM |
types.ghadr_used | boolean | null | Ghadr liquid-fuel MRBM |
types.sejjil_used | boolean | null | Sejjil solid-fuel MRBM |
types.kheibar_shekan_used | boolean | null | Kheibar Shekan solid-fuel |
types.fattah_used | boolean | null | Fattah-1 hypersonic glide vehicle |
types.shahed_136_used | boolean | null | Shahed-136 loitering munition |
types.shahed_131_used | boolean | null | Shahed-131 loitering munition |
categories.bm_hypersonic | boolean | Hypersonic weapon involved |
categories.bm_marv_equipped | boolean | Maneuverable reentry vehicle |
| Field | Type | Description |
|---|---|---|
israel_targeted | boolean | Israeli territory included in targeting |
us_bases_targeted | boolean | US/coalition bases included |
targets | string | Free-text target description |
landings_countries | string[] | ISO country codes of impact/landing countries |
israeli_locations.* | boolean | Flags for specific Israeli regions targeted |
us_bases[] | object[] | Named US/coalition base targets (name, country_code) |
us_naval_vessels[] | object[] | Named naval vessel targets |
| Field | Type | Description |
|---|---|---|
estimated_munitions_count | integer | null | Total munitions fired in this wave |
munitions_targeting_israel | integer | null | Subset targeting Israeli territory |
munitions_targeting_us_bases | integer | null | Subset targeting US/coalition facilities |
cumulative_total | integer | null | Running total across waves |
| Field | Type | Description |
|---|---|---|
intercepted | boolean | null | Interception occurred |
interception_systems | string[] | Systems used (Arrow-2, Arrow-3, THAAD, SM-3, Iron Dome, Patriot) |
intercepted_by.israel/us/uk/jordan | boolean | Per-country interception participation |
estimated_intercept_count | integer | null | Munitions intercepted |
estimated_intercept_rate | float | null | Fraction intercepted (0.0–1.0) |
exoatmospheric_interception | boolean | Arrow-3 or THAAD exo-atm intercept |
| Field | Type | Description |
|---|---|---|
damage | string | null | Free-text damage description |
fatalities | integer | null | Confirmed fatalities |
injuries | integer | null | Confirmed injuries |
civilian_casualties | boolean | null | Civilian casualties confirmed |
military_casualties | integer | null | Military casualties count |
File Structure
The canonical data files are:
data/tp3-2025/waves.json— TP3 wave data (schema v1.1, 22 waves)data/tp4-2026/waves.json— TP4 wave data (schema v2.1, 19+ waves)data/tp4-2026/waves.geojson— GeoJSON export of TP4 wavesdata/tp4-2026/waves.kml— KML exportdata/tp4-2026/reference/israeli_targets.json— Israeli targets with coordsdata/tp4-2026/reference/us_bases.json— US/coalition bases with coordsdata/tp4-2026/reference/launch_zones.json— Iranian launch zone centroidsdata/reference/iranian_weapons.json— Weapon system specificationsdata/reference/defense_systems.json— BMD/air defense system specsdata/schema/wave.schema.json— JSON Schema for validation
Sources
Data is cross-referenced from the following open sources:
Wikipedia: June 2025 Iranian strikes on Israel Wikipedia: Casualties of the Twelve-Day War FPRI: Shallow Ramparts — Air and Missile Defenses in the June 2025 War Times of Israel: The Israel-Iran war by the numbers ABNA24: A look at 22 waves of Iran's Operation True Promise IIIContributing
This dataset is maintained on GitHub. Corrections, additions, and source citations
are welcome via pull request or issue. The schema documentation in
data/schema/wave.schema.json and prompts/waves.md
describes the data extraction methodology.