Himaxym

FlightFinder Aviation Safety Data API

Read-only JSON API over FlightFinder's merged aviation-safety corpus: accident narratives aggregated from 120+ official investigation agencies, deduplicated…

Logistics & shipping#transportation

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Read-only JSON API over FlightFinder's merged aviation-safety corpus: accident narratives aggregated from 120+ official investigation agencies, deduplicated into one occurrence-level dataset with derived family analytics.

Authentication: Authorization: Bearer YOUR_KEY. The key must travel in the header — ?api_key= is rejected with 401 query_key_unsupported, because query strings end up in access logs and browser history.

Getting a key: keys belong to a himaxym.com account. Sign in, then POST /keys with your account's JWT in Authorization: Bearer — the response carries the raw API key exactly once (only a hash is stored). Up to 5 active keys per account; DELETE /keys/{id} frees a slot.

No key required to start: every GET data endpoint answers without any Authorization header at the keyless tier, 100 requests/day/IP.

Rate limits: no key — 100 requests/day/IP; free key — 1000/day and 60/minute; pro key — 20000/day and 60/minute. Daily quotas reset at UTC midnight; 429 responses carry a Retry-After header (seconds — time to UTC midnight for the daily quota, up to 60 for the per-minute limiter). A newly created key, or an upgrade to pro, can take up to 5 minutes to be visible to every worker.

Licensing: facts and merged/derived data are always returned in full. narrative_text is full for open-licensed sources (CC, OGL, Licence Ouverte/Etalab, public domain) and an ~300-char excerpt plus a source_url deep link otherwise — see GET /sources for the per-source policy. Every record carries source, attribution, license and a deep link; visible attribution is required when displaying or republishing.

Endpoints 18

  • GETList your API keys (metadata only)/keysAccount JWT as the bearer token. Never returns a secret — id, label and usage only.
  • POSTCreate an API key (account required)/keysSend your himaxym.com account JWT as the bearer token — NOT an API key. Returns the raw key exactly once; only a hash is stored. Up to 5 active keys per…
  • DELETERevoke one of your own API keys/keys/:idAccount JWT as the bearer token. Owner-scoped: a key that is not yours answers 404, not 403.
  • GETConnectivity / key check/ping
  • GETList occurrences (cursor pagination)/events
  • GETOne occurrence with sources and narrative refs/events/:id
  • GETNarrative by source + the authority's own case id/narratives/:source/:idnarrative_text is full for open-licensed sources, an ~300-char excerpt + source_url deep link otherwise (policy field on GET /sources). Published article…
  • GETFamily safety stats from the merged corpus/aircraft/:family/safety
  • GETFAA wildlife strike database — global aggregates (US-gov public domain)/wildlife-strikes
  • GETFAA wildlife strikes for one airport/wildlife-strikes/airport/:slug
  • GETFAA wildlife strikes for one species/wildlife-strikes/species/:slug
  • GETFAA reported laser incidents — global aggregates (US-gov public domain)/laser-strikes
  • GETFAA laser incidents for one US state/laser-strikes/state/:slug
  • GETFAA laser incidents near one airport/laser-strikes/airport/:slug
  • GETFAA UAS (drone) sighting reports — global aggregates (US-gov public domain)/drone-sightings
  • GETFAA drone sightings for one US state/drone-sightings/state/:slug
  • GETAirport reference lookup by ICAO ident or IATA code (OurAirports, CC0)/airports/:ident
  • GETThe source registry (licenses + narrative policy)/sources

API details

Base URL
https://himaxym.com/api/v1/data
Authentication
A bearer token in the Authorization header
Operations
18 operations on 17 pathsGET 16POST 1DELETE 1
Response formats
application/json
Description format
OpenAPI 3.0.3, API version 1.0.0

How to test the FlightFinder Aviation Safety Data API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the FlightFinder Aviation Safety Data API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “List your API keys (metadata only)” (GET /keys), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the FlightFinder Aviation Safety Data API?

Read-only JSON API over FlightFinder's merged aviation-safety corpus: accident narratives aggregated from 120+ official investigation agencies, deduplicated… It is listed under Logistics & shipping and has 18 endpoints.

Who publishes the FlightFinder Aviation Safety Data API?

It is listed from Himaxym's public API description (an OpenAPI document), not published by Himaxym on Swastik Codes. Anyone who controls himaxym.com can claim the profile by adding a DNS TXT record.

What is the base URL of the FlightFinder Aviation Safety Data API?

Requests go to https://himaxym.com/api/v1/data. Endpoint paths are added to this base URL.

How do I authenticate with the FlightFinder Aviation Safety Data API?

With A bearer token in the Authorization header.

How many endpoints does the FlightFinder Aviation Safety Data API have?

18 operations on 17 paths (16 GET, 1 POST, 1 DELETE).

Is forking the FlightFinder Aviation Safety Data API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.