curl "https://yogataraapi.prahlad.app/api/hazard/plane-crashes/" \
-H "X-API-Key: $OCCULT_API_KEY"A stored dataset of aviation accidents with a written account of each, going back to the 1920s. It is a historical event record rather than an astrological calculation, and sits alongside the chart endpoints so that a crash's time and place can be fed straight into a chart. Filter with `country`, `region`, `aircraft`, `operator`, `crash_cause`, `flight_phase` and `flight_type`, all case-insensitive substring matches, with `start_date` and `end_date` on the accident date, and with `min_fatalities`. `sort` accepts 'newest' (the default), 'oldest', 'name_asc' and 'name_desc' on the aircraft type, and 'fatalities_desc' or 'fatalities_asc'. Paging uses `page` and `itemsPerPage`, fifty per page by default and up to five hundred. The response is a paged envelope of `count`, `next`, `previous` and `results`. Each result carries the date and a local time string, the aircraft type and operator, the phase of flight and flight type, a crash site classification and free-text location, country and region, latitude and longitude, crew, passenger, other and total fatality counts, a stated `crash_cause` and a `circumstances` paragraph describing what happened.
| Parameter | Type | Example | What it does | |
|---|---|---|---|---|
| aircraft | string | — | Filter by aircraft (case-insensitive contains) FREE-FORM; case-insensitive `icontains` substring match on the aircraft type. | |
| country | string | — | Filter by country (case-insensitive contains) | |
| crash_cause | string | — | Filter by crash cause (case-insensitive contains) | |
| end_date | string | — | Filter by end date (YYYY-MM-DD) FORMAT constraint: 'YYYY-MM-DD'. Compared with `date__lte`. | |
| flight_phase | string | — | Filter by flight phase (case-insensitive contains) | |
| flight_type | string | — | Filter by flight type (case-insensitive contains) | |
| itemsPerPage | integer | — | Number of items per page | |
| min_fatalities | integer | — | Filter by minimum total fatalities | |
| operator | string | — | Filter by operator (case-insensitive contains) FREE-FORM; case-insensitive `icontains` substring match on the operator/airline. | |
| page | integer | — | Page number | |
| region | string | — | Filter by region (case-insensitive contains) | |
| sort | string | — | Sort order: 'newest' (default), 'oldest', 'name_asc' (aircraft A-Z), 'name_desc' (Z-A), 'fatalities_desc' (highest fatalities first), or 'fatalities_asc' (lowest first) Case-insensitive and stripped. Default 'newest'. 'name_asc'/'name_desc' sort by AIRCRAFT (name_field='aircraft', not by a person's name. Unrecognised values silently fall back to 'newest'. one of: newest, oldest, name_asc, name_desc, fatalities_desc, fatalities_asc | |
| start_date | string | — | Filter by start date (YYYY-MM-DD) FORMAT constraint: 'YYYY-MM-DD'. Compared with `date__gte`. |