curl "https://yogataraapi.prahlad.app/api/hazard/forest-fires/" \
-H "X-API-Key: $OCCULT_API_KEY"A stored dataset of large forest fire detections, organised by the Indian forest administrative hierarchy. It is a historical event log, not an astrological calculation, and is provided for mundane and correlation work alongside the chart endpoints. Filter with `state`, `district`, `circle`, `division` and `fire_name`, all case-insensitive substring matches, and with `start_date`/`end_date` against the first detection time (accepting either YYYY-MM-DD or a full ISO timestamp). `sort` takes 'newest' (the default), 'oldest', 'name_asc' or 'name_desc' on the fire name. Paging uses `page` and `itemsPerPage`, fifty per page by default and up to five hundred. The response is a standard paged envelope of `count`, `next`, `previous` and `results`. Each result gives an id, `first_detection` and `last_detection` timestamps, the state, district, forest circle, division and range, a fire name and the point coordinates as `latitude` and `longitude`. Administrative fields are null for detections outside a mapped forest division.
| Parameter | Type | Example | What it does | |
|---|---|---|---|---|
| circle | string | — | Filter by circle name (case-insensitive contains) | |
| district | string | — | Filter by district name (case-insensitive contains) | |
| division | string | — | Filter by division name (case-insensitive contains) | |
| end_date | string | — | Filter by end date/time (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS) FORMAT constraint: 'YYYY-MM-DD' or 'YYYY-MM-DDTHH:MM:SS'. Compared with `first_detection__lte`. | |
| fire_name | string | — | Filter by fire name (case-insensitive contains) FREE-FORM; case-insensitive `icontains` substring match on the fire name. | |
| itemsPerPage | integer | — | Number of items per page | |
| page | integer | — | Page number | |
| sort | string | — | Sort order: 'newest' (default), 'oldest', 'name_asc' (fire name A-Z), or 'name_desc' (Z-A) Case-insensitive and whitespace-stripped. Default 'newest'. ANY unrecognised value silently falls back to 'newest' rather than erroring. 'name_asc'/'name_desc' sort by fire_name. Nulls are always pushed last. one of: newest, oldest, name_asc, name_desc | |
| start_date | string | — | Filter by start date/time (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS) FORMAT constraint: 'YYYY-MM-DD' or 'YYYY-MM-DDTHH:MM:SS'. Compared with `first_detection__gte`. | |
| state | string | — | Filter by state name (case-insensitive contains) |