A read-only JSON API over FlightFinder’s merged aviation-safety corpus: 138,708 accident narratives aggregated from 117 official sources — national investigation agencies, the NTSB, ATSB, MAK and more — deduplicated into one occurrence-level dataset with our derived analytics on top. Free keyed access, per-record attribution built in.
Quickstart
1. Create a key (shown once — store it immediately, we keep only a hash):
curl -X POST https://himaxym.com/api/v1/data/keys \
-H 'Content-Type: application/json' \
-d '{"label":"my-app"}'2. Page through events (cursor pagination, combinable filters):
curl 'https://himaxym.com/api/v1/data/events?family=boeing-737&fatal=1&limit=25' \
-H 'Authorization: Bearer YOUR_KEY'3. Fetch one narrative by the authority’s own case id:
curl 'https://himaxym.com/api/v1/data/narratives/atsb/AO-2024-001' \
-H 'Authorization: Bearer YOUR_KEY'Endpoints
| Endpoint | Returns |
|---|---|
GET /api/v1/data/ping | Connectivity / key check — the cheapest way to verify a key works. |
GET /api/v1/data/events | Paginated occurrences. Filters: from, to, country, type (ICAO), family (slug), operator, fatal=1; limit ≤ 100, cursor pagination. |
GET /api/v1/data/events/{id} | One occurrence with per-source attribution links and narrative refs. |
GET /api/v1/data/narratives/{source}/{id} | Narrative by the authority’s own case id — full text for open-licensed sources, excerpt + deep link otherwise. |
GET /api/v1/data/aircraft/{family}/safety | Family-level safety stats from the merged corpus + the ICAO type list. |
GET /api/v1/data/sources | The source registry: code, name, license, homepage, narrative count, policy. |
Authentication: Authorization: Bearer YOUR_KEY or ?api_key=YOUR_KEY.
Errors share one shape: {"error":{"code","message"}} — 401 for a bad key,
429 with a Retry-After header when a limit is hit.
Rate limits
| Tier | Daily | Per minute |
|---|---|---|
| No key | 100 / day / IP | — |
| Free key | 1,000 / day | 60 |
| Pro (coming soon) | 20,000 / day | 60 |
Sources, licenses & narrative policy
Facts and our merged occurrence/analytics layers are always returned in full.
narrative_text follows the source license: full for
open-licensed sources (CC, OGL, Licence Ouverte/Etalab, public domain),
excerpt (~300 chars + a deep link to the original report) for
attribution-style sources. The same table is available as JSON at
https://himaxym.com/api/v1/data/sources.
Full source & license table (117 sources)
| Code | Source | License | Narrative policy |
|---|---|---|---|
ntsb |
NTSB | public domain (NTSB) | full |
mak |
the Interstate Aviation Committee (MAK) | MAK official investigation reports | excerpt |
wikidata |
Wikidata contributors | CC0 (Wikidata) | full |
atsb |
the Australian Transport Safety Bureau (ATSB) | CC-BY 4.0 (ATSB) | full |
baaa |
the Bureau of Aircraft Accidents Archives (B3A) | Bureau of Aircraft Accidents Archives (B3A) | excerpt |
aacsv |
the Autoridad de Aviacion Civil de El Salvador (AAC) | Autoridad de Aviacion Civil (AAC), El Salvador | excerpt |
aaiahk |
the Air Accident Investigation Authority of Hong Kong (AAIA) | Air Accident Investigation Authority (AAIA), Hong Kong SAR | excerpt |
aaiasb |
the Air Accident Investigation and Aviation Safety Board of Greece (AAIASB) | Air Accident Investigation and Aviation Safety Board (AAIASB), Greece | excerpt |
aaib |
the UK Air Accidents Investigation Branch (AAIB) | UK Open Government Licence v3.0 (AAIB) | full |
aaibly |
the Aircraft Accident and Incident Investigation Bureau of Libya (AAIB) | Aircraft Accident and Incident Investigation Bureau (AAIB), Ministry of Transport, Libya | excerpt |
aaibmm |
the Aircraft Accident Investigation Bureau of Myanmar (AAIB Myanmar) | Aircraft Accident Investigation Bureau (AAIB), Department of Civil Aviation, Myanmar | excerpt |
aaibmn |
the Aviation Accident Investigation Bureau of Mongolia (AAIB) | Aviation Accident Investigation Bureau (AAIB), Mongolia | excerpt |
aaibmy |
the Air Accident Investigation Bureau of Malaysia (AAIB Malaysia) | Air Accident Investigation Bureau (AAIB), Malaysia - Ministry of Transport | excerpt |
aaibzm |
the Aircraft Accident Investigation Board, Zambia (AAIB) | Aircraft Accident Investigation Board (AAIB), Zambia | excerpt |
aaicmv |
the Accident Investigation Coordinating Committee of the Maldives (AICC) | Accident Investigation Coordinating Committee (AICC), Maldives Civil Aviation Authority | excerpt |
aaicnp |
the Aircraft Accident Investigation Commission of Nepal (AAIC) | Aircraft Accident Investigation Commission (AAIC), Civil Aviation Authority of Nepal (CAAN) | excerpt |
aaicth |
the Aircraft Accident Investigation Committee of Thailand (AAIC) | Aircraft Accident Investigation Committee (AAIC), Ministry of Transport, Thailand | excerpt |
aaid |
the Aircraft Accident Investigation Department of Kenya (AAID) | Aircraft Accident Investigation Department (AAID), Ministry of Roads and Transport, Kenya | excerpt |
aaig |
the Aircraft Accident Investigation Group of Bangladesh (AAIG, CAAB) | Aircraft Accident Investigation Group (AAIG), Civil Aviation Authority of Bangladesh | excerpt |
aaiib |
the Aircraft Accident Investigation and Inquiry Board of the Philippines (AAIIB) | Aircraft Accident Investigation and Inquiry Board (AAIIB), Civil Aviation Authority of the Philippines (CAAP) | excerpt |
aaiibcy |
the Aircraft Accident and Incident Investigation Board of Cyprus (AAIIB) | Aircraft Accident and Incident Investigation Board (AAIIB), Republic of Cyprus | excerpt |
aaikz |
the Transport Accident and Incident Investigation Department of Kazakhstan (Ministry of Transport) | Ministry of Transport of the Republic of Kazakhstan - accident investigation reports | excerpt |
aaisl |
the Aircraft Accident and Incident Investigation of the Civil Aviation Authority of Sri Lanka (AAII) | Aircraft Accident and Incident Investigation, Civil Aviation Authority of Sri Lanka | excerpt |
aaiu |
the Irish Air Accident Investigation Unit (AAIU) | Air Accident Investigation Unit (AAIU), Ireland - Department of Transport | excerpt |
aaiube |
the Belgian Air Accident Investigation Unit (AAIU(Be)) | Air Accident Investigation Unit (AAIU(Be)), Belgium - FPS Mobility and Transport | excerpt |
aaiubg |
the Aircraft Accident Investigation Unit of Bulgaria (AAIU), Ministry of Transport | Aircraft Accident Investigation Unit (AAIU), Ministry of Transport and Communications, Bulgaria | excerpt |
aaiuz |
the Aviation Accident Investigation Service of Uzbekistan (Mintrans) | CC-BY 4.0 (Ministry of Transport, Republic of Uzbekistan) | full |
aet |
the Administration des enquetes techniques, Luxembourg (AET) | Administration des enquetes techniques (AET), Luxembourg | excerpt |
agacgn |
the Guinean Civil Aviation Authority accident investigation unit (AGAC) | Agence Guineenne de l Aviation Civile (AGAC), Republic of Guinea | excerpt |
aias |
the Romanian Safety Investigation and Analysis Authority for Civil Aviation (AIAS) | Autoritatea de Investigatii si Analiza pentru Siguranta Aviatiei Civile (AIAS), Romania | excerpt |
aibdk |
the Danish Accident Investigation Board (Havarikommissionen) | Havarikommissionen - Accident Investigation Board Denmark | excerpt |
aibsa |
the Saudi Arabian Aviation Investigation Bureau (AIB) | Aviation Investigation Bureau (AIB), Kingdom of Saudi Arabia | excerpt |
aicpng |
the Accident Investigation Commission of Papua New Guinea (AIC) | Accident Investigation Commission (AIC), Papua New Guinea | excerpt |
ainhr |
the Air, Maritime and Railway Traffic Accident Investigation Agency of Croatia (AIN) | Agencija za istrazivanje nesreca u zracnom, pomorskom i zeljeznickom prometu (AIN), Croatia | excerpt |
akisa |
the National Authority of Air Accident and Incident Investigation of Albania (AKISA) | National Authority of Air Accident and Incident Investigation (AKISA), Republic of Albania | excerpt |
anacdz |
the Algerian National Civil Aviation Agency investigation bureau (ANAC) | Agence Nationale de l Aviation Civile (ANAC), Algeria | excerpt |
ansv |
the Italian National Flight Safety Agency (ANSV) | Agenzia Nazionale per la Sicurezza del Volo (ANSV), Italy | excerpt |
araib |
the Korean Aviation and Railway Accident Investigation Board (ARAIB) | Aviation and Railway Accident Investigation Board (ARAIB), Republic of Korea | excerpt |
baaid |
the Air Accident Investigation Department of the Bahamas (AAID) | Air Accident Investigation Department (AAID), The Bahamas | excerpt |
bdca |
the Belize Department of Civil Aviation Aircraft Accident Investigation Unit (DCA) | Department of Civil Aviation (DCA), Belize | excerpt |
bea |
the French Bureau d'Enquêtes et d'Analyses (BEA) | Licence Ouverte / Etalab 2.0 (BEA) | full |
beabj |
the Bureau Enquetes et Analyses of Benin (BEA Benin) | Bureau Enquetes et Analyses (BEA), Republic of Benin | excerpt |
beacg |
the Bureau d'Enquetes et d'Analyses, Congo-Brazzaville (BEA) | Bureau d'Enquetes et d'Analyses (BEA), Congo-Brazzaville | excerpt |
beaci |
the Bureau Enquetes Accidents d'Aviation of Cote d'Ivoire (BEA-CI) | Bureau Enquetes Accidents d'Aviation (BEA), Cote d'Ivoire | excerpt |
beam |
the Moroccan Bureau of Civil Aviation Accident Investigation (BEAM) | Bureau d'Enquetes et d'Analyses pour la securite de l'aviation civile (BEAM), Morocco | excerpt |
beasn |
the Bureau Enquetes et Analyses of Senegal (BEA Senegal) | Bureau Enquetes et Analyses (BEA), Republic of Senegal | excerpt |
bfu |
the German Federal Bureau of Aircraft Accident Investigation (BFU) | Bundesstelle für Flugunfalluntersuchung (BFU), Germany | excerpt |
bhdca |
the Directorate of Civil Aviation of Bosnia and Herzegovina (BHDCA) | Directorate of Civil Aviation (BHDCA), Bosnia and Herzegovina | excerpt |
caav |
the Civil Aviation Authority of Vietnam (CAAV) | Civil Aviation Authority of Vietnam (CAAV) | excerpt |
caavvu |
the Civil Aviation Authority of Vanuatu (CAAV) | CC-BY 4.0 (Civil Aviation Authority of Vanuatu) | full |
caoiri |
the Aircraft Accident Investigation Board of the Civil Aviation Organization of Iran (CAO.IRI AIG) | Civil Aviation Organization (CAO), Islamic Republic of Iran | excerpt |
cenipa |
the Brazilian Aeronautical Accident Investigation and Prevention Center (CENIPA) | Centro de Investigacao e Prevencao de Acidentes Aeronauticos (CENIPA), Brazil - Comando da Aeronautica | excerpt |
ciaado |
the Aircraft Accident Investigation Commission of the Dominican Republic (CIAA) | Comision Investigadora de Accidentes de Aviacion (CIAA), Dominican Republic | excerpt |
ciaape |
the Aircraft Accident Investigation Commission of Peru (CIAA), Ministry of Transport and Communications | Comision de Investigacion de Accidentes de Aviacion (CIAA), Ministerio de Transportes y Comunicaciones, Peru | excerpt |
ciaiac |
the Spanish Civil Aviation Accident and Incident Investigation Commission (CIAIAC) | Comision de Investigacion de Accidentes e Incidentes de Aviacion Civil (CIAIAC), Spain - Ministerio de Transportes y Movilidad Sostenible | excerpt |
ciaiauy |
the Aircraft Accident and Incident Investigation Commission of Uruguay (CIAIA) | Comision de Investigacion de Accidentes e Incidentes de Aviacion (CIAIA), Uruguay | excerpt |
cins |
the Center for Investigation of Transport Accidents of Serbia (CINS) | Centar za istrazivanje nesreca u saobracaju (CINS), Republic of Serbia | excerpt |
daaina |
the Directorate of Aircraft Accident Investigations of Namibia (DAAI) | Directorate of Aircraft Accident Investigations (DAAI), Ministry of Works and Transport, Namibia | excerpt |
daibw |
the Directorate of Accident Investigation of Botswana (DAI) | Directorate of Accident Investigation (DAI), Ministry of Transport, Botswana | excerpt |
dgacbo |
the Aircraft Accident Investigation Area of the Bolivian DGAC (AIG) | Direccion General de Aeronautica Civil (DGAC), Estado Plurinacional de Bolivia | excerpt |
dgaccl |
the Chilean Directorate General of Civil Aeronautics (DGAC Chile) | Direccion General de Aeronautica Civil (DGAC), Chile | excerpt |
dgaccr |
the Costa Rican Civil Aviation Directorate (DGAC Costa Rica) | Direccion General de Aviacion Civil (DGAC), Costa Rica | excerpt |
dgacec |
the Ecuadorian Civil Aviation Directorate (DGAC Ecuador) | Direccion General de Aviacion Civil (DGAC), Ecuador | excerpt |
dgacgt |
the Aircraft Accident Investigation Unit of the Guatemalan Directorate General of Civil Aviation (UIA/DGAC) | Unidad de Investigacion de Accidentes, Direccion General de Aeronautica Civil (DGAC), Guatemala | excerpt |
dgcakw |
the Kuwaiti Directorate General of Civil Aviation (DGCA Kuwait) | Directorate General of Civil Aviation (DGCA), Kuwait | excerpt |
dgcalb |
the Lebanese Directorate General of Civil Aviation (DGCA Lebanon) | Direction Generale de l Aviation Civile (DGCA), Lebanese Republic | excerpt |
eaaid |
the Egyptian Aircraft Accident Investigation Directorate (EAAID) | Aircraft Accident Investigation Directorate (EAAID), Egyptian Civil Aviation Authority | excerpt |
eaibet |
the Ethiopian Aircraft Accident Investigation Bureau (EAIB) | Aircraft Accident Investigation Bureau (EAIB), Ethiopian Civil Aviation Authority | excerpt |
eccaa |
the Eastern Caribbean Civil Aviation Authority (ECCAA) | Eastern Caribbean Civil Aviation Authority (ECCAA) | excerpt |
gcaa |
the UAE Air Accident Investigation Sector (GCAA AAIS) | Air Accident Investigation Sector (AAIS), General Civil Aviation Authority (GCAA), United Arab Emirates | excerpt |
gcaagy |
the Guyana Civil Aviation Authority Aircraft Accident Investigation Unit (GCAA) | Guyana Civil Aviation Authority (GCAA), Aircraft Accident Investigation Unit | excerpt |
ghana |
the Aircraft Accident and Incident Investigation and Prevention Bureau of Ghana (AIB Ghana) | Aircraft Accident and Incident Investigation and Prevention Bureau (AIB), Ghana | excerpt |
gpiaaf |
the Portuguese Office for the Prevention and Investigation of Accidents in Civil Aviation and Rail (GPIAAF) | Gabinete de Prevencao e Investigacao de Acidentes com Aeronaves e de Acidentes Ferroviarios (GPIAAF), Portugal | excerpt |
griaa |
the Aircraft Accident Investigation Group of the Colombian Civil Aviation Authority (GRIAA) | Grupo de Investigacion de Accidentes, Unidad Administrativa Especial de Aeronautica Civil (Aerocivil), Colombia | excerpt |
iacm |
the Mozambique Civil Aviation Institute (IACM) | Instituto da Aviacao Civil de Mocambique (IACM) | excerpt |
india |
the Aircraft Accident Investigation Bureau of India (AAIB India) | Aircraft Accident Investigation Bureau (AAIB), India - Ministry of Civil Aviation | excerpt |
ipiaam |
the Aviation and Maritime Accident Investigation Institute of Cabo Verde (IPIAAM) | Instituto de Prevencao e Investigacao de Acidentes Aeronauticos e Maritimos (IPIAAM), Cabo Verde | excerpt |
israel |
the Chief Investigator of Aircraft Accidents, Israel Ministry of Transport | Chief Investigator of Aircraft Accidents and Incidents, Ministry of Transport, Israel | excerpt |
jcaa |
the Jamaica Civil Aviation Authority (JCAA) | Jamaica Civil Aviation Authority (JCAA) | excerpt |
jiaacve |
the Venezuelan Civil Aviation Accident Investigation Board (JIAAC Venezuela) | Junta de Investigacion de Accidentes de Aviacion Civil (JIAAC), Venezuela - MppT | excerpt |
jst |
the Argentine Transportation Safety Board (JST) | Junta de Seguridad en el Transporte (JST), Argentina | excerpt |
jtsb |
the Japan Transport Safety Board (JTSB) | Japan Transport Safety Board (JTSB) - Ministry of Land, Infrastructure, Transport and Tourism | excerpt |
kbsz |
the Transportation Safety Bureau of Hungary (KBSZ) | Kozlekedesbiztonsagi Szervezet (KBSZ), Hungary | excerpt |
kinsiv |
the Aviation Accident and Incident Investigation Committee of North Macedonia (KINSIV) | Committee for Investigation of Aviation Accidents and Serious Incidents (KINSIV), North Macedonia | excerpt |
knkt |
the Indonesian National Transportation Safety Committee (KNKT) | Komite Nasional Keselamatan Transportasi (KNKT) - National Transportation Safety Committee, Indonesia | excerpt |
malta |
the Bureau of Air Accident Investigation of Malta (BAAI) | Bureau of Air Accident Investigation (BAAI), Malta | excerpt |
mexico |
the Federal Civil Aviation Agency of Mexico (AFAC) | Agencia Federal de Aviacion Civil (AFAC), Mexico | excerpt |
mzisi |
the Slovenian aircraft accident investigation service, Ministry of Infrastructure (MzI) | Ministrstvo za infrastrukturo (MzI), Republic of Slovenia - air accident investigation | excerpt |
nbaai |
the National Bureau of Air Accident Investigation of Ukraine (NBAAI) | National Bureau of Air Accident Investigation of Ukraine (NBAAI) | excerpt |
nsia |
the Norwegian Safety Investigation Authority (NSIA) | Norwegian Safety Investigation Authority (NSIA) / Statens havarikommisjon, Norway | excerpt |
nsib |
the Nigeria Safety Investigation Bureau (NSIB) | Nigeria Safety Investigation Bureau (NSIB) | excerpt |
ntsb1962 |
the U.S. National Transportation Safety Board (NTSB) historical archive (1962-1981) | public domain (NTSB, U.S. Government work) | full |
ntsbpre |
the U.S. National Transportation Safety Board (NTSB) historical archive | National Transportation Safety Board (NTSB), United States | excerpt |
ojk |
the Estonian Safety Investigation Bureau (OJK) | Ohutusjuurdluse Keskus (OJK), Estonia | excerpt |
otkes |
the Safety Investigation Authority Finland (OTKES) | Onnettomuustutkintakeskus (OTKES), Finland | excerpt |
otsb |
the Oman Transport Safety Bureau (OTSB) | Oman Transport Safety Bureau (OTSB), Ministry of Transport, Communications and IT, Sultanate of Oman | excerpt |
ovv |
the Dutch Safety Board (Onderzoeksraad voor Veiligheid) | Dutch Safety Board (Onderzoeksraad voor Veiligheid, OVV), Netherlands | excerpt |
pkbwl |
the Polish State Commission on Aircraft Accidents Investigation (PKBWL) | Panstwowa Komisja Badania Wypadkow Lotniczych (PKBWL), Poland | excerpt |
rnsa |
the Icelandic Transportation Safety Board (RNSA) | Rannsoknarnefnd samgonguslysa (RNSA), Iceland | excerpt |
sacaa |
the South African Civil Aviation Authority (SACAA) Accident and Incident Investigations Division | South African Civil Aviation Authority (SACAA) - Accident and Incident Investigations Division (AIID) | excerpt |
shk |
the Swedish Accident Investigation Authority (SHK) | Statens haverikommission (SHK) - Swedish Accident Investigation Authority, Sweden | excerpt |
sibpk |
the Safety Investigation Board of Pakistan (SIB/BASI) | Safety Investigation Board (SIB) / Board of Air Safety Investigation, Pakistan | excerpt |
sub |
the Austrian Federal Safety Investigation Authority (SUB) | Sicherheitsuntersuchungsstelle des Bundes (SUB), Austria | excerpt |
sust |
the Swiss Transportation Safety Investigation Board (STSB / SUST) | Swiss Transportation Safety Investigation Board (STSB), Switzerland | excerpt |
svk |
the Aviation and Maritime Investigation Unit, Ministry of Transport of the Slovak Republic | Letecky a namorny vysetrovaci utvar, Ministry of Transport, Slovakia | excerpt |
taibtz |
the Tanzania Aircraft Accident Investigation Bureau (AAIB Tanzania) | Aircraft Accident Investigation Bureau (AAIB), Ministry of Transport, Tanzania | excerpt |
taic |
the New Zealand Transport Accident Investigation Commission (TAIC) | Transport Accident Investigation Commission (TAIC), New Zealand | excerpt |
taiib |
the Transport Accident and Incident Investigation Bureau of Latvia (TAIIB) | Transporta nelaimes gadijumu un incidentu izmeklesanas birojs (TAIIB), Latvia | excerpt |
taits |
the Transport Accident and Incident Investigation Service of Lithuania (TAITS) | Transporto avariju ir incidentu tyrimu skyrius (TAITS), Lithuania | excerpt |
tsb |
the Transportation Safety Board of Canada (TSB) | Transportation Safety Board of Canada (TSB) - Crown copyright, reproduced under the Government of Canada non-commercial reproduction terms | excerpt |
tsib |
the Singapore Transport Safety Investigation Bureau (TSIB) | Transport Safety Investigation Bureau (TSIB), Singapore - Ministry of Transport | excerpt |
ttcaa |
the Trinidad and Tobago Civil Aviation Authority (TTCAA) | Trinidad and Tobago Civil Aviation Authority (TTCAA) | excerpt |
ttsb |
the Taiwan Transportation Safety Board (TTSB) | Taiwan Transportation Safety Board (TTSB), Taiwan | excerpt |
ueim |
the Turkish Transport Safety Investigation Center (UEIM) | Ulasim Emniyeti Inceleme Merkezi (UEIM), Turkiye | excerpt |
ukmaa |
the UK Defence Safety Authority / Military Aviation Authority (Service Inquiries) | Defence Safety Authority / Military Aviation Authority, UK — Crown Copyright, OGL v3.0 | full |
usafaib |
the U.S. Air Force Accident Investigation Board (AIB) | U.S. Air Force Accident Investigation Board (AIB) — public domain (U.S. Government work) | full |
uzpln |
the Czech Air Accidents Investigation Institute (UZPLN) | Ustav pro odborne zjistovani pricin leteckych nehod (UZPLN), Czech Republic | excerpt |
Terms of use
- Attribution is required. Every record carries
source,attribution,licenseand a deep link — anything you display or publish must show visible attribution with a link to the original source (and to the FlightFinder page for our derived articles and analytics). - Excerpts stay excerpts. Where the API returns an excerpt + link, fetch the full text from the linked source under its own license — don’t reconstruct it.
- Paid tier — coming soon. Pro keys will unlock full LLM-article text under a no-public-republication license: internal use, applications and research are permitted, open-web republication is forbidden, and a visible attribution link to the canonical FlightFinder page is required.
- The API is read-only and provided as-is; abusive traffic and key-pooling get keys revoked.
Get an API key
Self-serve, no email required: send POST https://himaxym.com/api/v1/data/keys with a label
(see the quickstart above) or use the form on this page. The key is shown exactly once —
we store only a hash.