Skip to content
Occult API
GET/api/hazard/forest-fires/1 credit

Forest fires

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.

https://yogataraapi.prahlad.app/api/hazard/forest-fires/
Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…

Query parameters (10)

Passed in the URL. All optional unless marked, and they combine — filter, then page, then sort.

ParameterTypeExampleWhat it does
circlestring—Filter by circle name (case-insensitive contains)
districtstring—Filter by district name (case-insensitive contains)
divisionstring—Filter by division name (case-insensitive contains)
end_datestring—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_namestring—Filter by fire name (case-insensitive contains)

FREE-FORM; case-insensitive `icontains` substring match on the fire name.

itemsPerPageinteger—Number of items per page
pageinteger—Page number
sortstring—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_datestring—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`.

statestring—Filter by state name (case-insensitive contains)

Example request

curl "https://yogataraapi.prahlad.app/api/hazard/forest-fires/" \
  -H "X-API-Key: $OCCULT_API_KEY"

Response

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"count\": 100, \"next\": \"http://127.0.0.1:8000/api/hazard/forest-fires/?page=2\", \"previous\": null, \"results\": [{\"id\": 66, \"first_detection\": \"2025-06-09T13:30:00+05:30\", \"last_detection\": \"2025-06-09T13:30:00+05:30\", \"state\": \"UTTAR PRADESH\", \"district\": \"AGRA\", \"circle\": null, \"division\": null, \"range_name\": null, \"fire_name\": \"AGRA -1\", \"longitude\": 78.26051634, \"latitude\": 26.83035862}, {\"id\": 9, \"first_detection\": \"2025-04-29T01:48:00+05:30\", \"last_detection\": \"2025-04-29T01:48:00+05:30\", \"state\": \"RAJASTHAN\", \"district\": \"SIROHI\", \"circle\": \"CCF JODHPUR CIRCLE\", \"division\": \"SIROHI DIVISION\", \"range_name\": \"ABU ROAD RANGE\", \"fire_name\": \"ABU ROAD -5\", \"longitude\": 72.88706718, \"latitude\": 24.50238094}, {\"id\": 65, \"first_detection\": \"2025-04-28T02:07:00+05:30\", \"last_detection\": \"2025-04-29T01:48:00+05:30\", \"state\": \"HIMACHAL PRADESH\", \"district\": \"HAMIRPUR\", \"circle\": \"HAMIRPUR CIRCLE\", \"division\": \"HAMIRPUR DIVISION\", \"range_name\": \"AGHAR RANGE\", \"fire_name\": \"AGHAR -2\", \"longitude\": 76.54487903, \"latitude\": 31.61348206}, {\"id\": 20, \"first_detection\": \"2025-04-27T13:36:00+05:30\", \"last_detection\": \"2025-04-27T13:36:00+05:30\", \"state\": \"ANDHRA PRADESH\", \"district\": \"ALLURI SITHARAMA RAJU\", \"circle\": \"RAJAHMUNDRY CIRCLE\", \"division\": \"RAMPACHODAVARAM DIVISION\", \"range_name\": \"ADDATEEGALA RANGE\", \"fire_name\": \"ADDATEEGALA -8\", \"longitude\": 81.84477321, \"latitude\": 17.71221588}, {\"id\": 64, \"first_detection\": \"2025-04-26T13:54:00+05:30\", \"last_detection\": \"2025-04-26T13:54:00+05:30\", \"state\": \"HIMACHAL PRADESH\", \"district\": \"HAMIRPUR\", \"circle\": \"HAMIRPUR CIRCLE\", \"division\": \"HAMIRPUR DIVISION\", \"range_name\": \"AGHAR RANGE\", \"fire_name\": \"AGHAR -1\", \"longitude\": 76.56248482, \"latitude\": 31.57775419}, {\"id\": 70, \"first_detection\": \"2025-04-23T13:10:00+05:30\", \"last_detection\": \"2025-04-23T13:10:00+05:30\", \"state\": \"MADHYA PRADESH\", \"district\": \"SHEOPUR\", \"circle\": \"KUNO VAN PRANI SHEOPUR CIRCLE\", \"division\": \"KUNO PALPUR VAN PRANI SHEOPUR DIVISION\", \"range_name\": \"AGRA WEST RANGE\", \"fire_name\": \"AGRA WEST -4\", \"longitude\": 77.20371276, \"latitude\": 25.993098}, {\"id\": 100, \"first_detection\": \"2025-04-20T14:06:00+05:30\", \"last_detection\": \"2025-04-20T14:06:00+05:30\", \"state\": \"MAHARASHTRA\", \"district\": \"AHMEDNAGAR\", \"circle\": \"WILDLIFE WEST CIRCLE\", \"division\": \"CCF WILDLIFE PUNE DIVISION\", \"range_name\": \"REHEKURI RANGE\", \"fire_name\": \"AHMEDNAGAR -36\", \"longitude\": 75.14123428, \"latitude\": 18.52634684}, {\"id\": 99, \"first_detection\": \"2025-04-19T14:25:00+05:30\", \"last_detection\": \"2025-04-19T14:25:00+05:30\", \"state\": \"MAHARASHTRA\", \"district\": \"AHMEDNAGAR\", \"circle\": \"NASHIK CIRCLE\", \"division\": \"AHMEDNAGAR DIVISION\", \"range_name\": \"PARNER RANGE\", \"fire_name\": \"AHMEDNAGAR -35\", \"longitude\": 74.32290649, \"latitude\": 19.14418074}, {\"id\": 69, \"first_detection\": \"2025-04-17T02:13:00+05:30\", \"last_detection\": \"2025-04-17T02:13:00+05:30\", \"state\": \"MADHYA PRADESH\", \"district\": \"SHEOPUR\", \"circle\": \"KUNO VAN PRANI SHEOPUR CIRCLE\", \"division\": \"KUNO PALPUR VAN PRANI SHEOPUR DIVISION\", \"range_name\": \"AGRA WEST RANGE\", \"fire_name\": \"AGRA WEST -3\", \"longitude\": 77.20165544, \"latitude\": 25.95699487}, {\"id\": 98, \"first_detection\": \"2025-04-16T02:31:00+05:30\", \"last_detection\": \"2025-04-16T02:31:00+05:30\", \"state\": \"MAHARASHTRA\", \"district\": \"AHMEDNAGAR\", \"circle\": \"NASHIK CIRCLE\", \"division\": \"SANGAMNER DIVISION\", \"range_name\": \"RAJUR RANGE\", \"fire_name\": \"AHMEDNAGAR -34\", \"longitude\": 73.90079744, \"latitude\": 19.6026871}, {\"id\": 97, \"first_detection\": \"2025-04-16T02:31:00+05:30\", \"last_detection\": \"2025-04-16T02:31:00+05:30\", \"state\": \"MAHARASHTRA\", \"district\": \"AHMEDNAGAR\", \"circle\": \"NASHIK CIRCLE\", \"division\": \"AHMEDNAGAR DIVISION\", \"range_name\": \"PARNER RANGE\", \"fire_name\": \"AHMEDNAGAR -33\", \"longitude\": 74.57595382, \"latitude\": 18.97076079}, {\"id\": 96, \"first_detection\": \"2025-04-14T14:19:00+05:30\", \"last_detection\": \"2025-04-14T14:19:00+05:30\", \"state\": \"MAHARASHTRA\", \"district\": \"AHMEDNAGAR\", \"circle\": \"NASHIK CIRCLE\", \"division\": \"AHME"
}

Captured from a real call using the exact request above. Results sit under data.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.