DEVELOPER & AI AGENT OPEN REST API
Public Disaster Data API Documentation
Free, public, CORS-enabled REST API endpoints providing real-time structured JSON telemetry for developers, AI assistants, and emergency applications.
Official Sources: India Meteorological Department (IMD), Central Water Commission (CWC), KSDMA
Updated: 07:23 pm IST
Next Sync: 07:38 pm
REST API Specifications v1.0Data Provenance & Specs
GET
/api/weatherFetch district-wise rainfall telemetry, 24h accumulation, and active weather alerts.
Example JSON ResponseContent-Type: application/json
{
"status": "success",
"timestamp": "2026-08-03T23:30:00.000Z",
"data": {
"district": "Kozhikode",
"rainfall24h": 142.5,
"alertLevel": "Orange",
"riskScore": 78
}
}GET
/api/riversFetch live streamflow water levels, danger thresholds, and warning status for 44 major rivers.
Example JSON ResponseContent-Type: application/json
{
"status": "success",
"totalCount": 44,
"data": [
{
"name": "Periyar River",
"station": "Neeleswaram",
"currentLevel": 6.85,
"dangerLevel": 7.5,
"status": "Warning"
}
]
}GET
/api/damsFetch reservoir storage capacity, water level meters, and spillway shutter counts for 81 dams.
Example JSON ResponseContent-Type: application/json
{
"status": "success",
"data": [
{
"name": "Idukki Dam",
"capacityPercentage": 88.4,
"shuttersOpen": 2,
"outflowRate": 150
}
]
}GET
/api/alertsFetch active Red, Orange, and Yellow disaster alerts issued by KSDMA and IMD.
Example JSON ResponseContent-Type: application/json
{
"status": "success",
"data": [
{ "districtName": "Wayanad", "alertLevel": "Red", "riskScore": 92 }
]
}GET
/api/campsFetch active relief shelters, capacity numbers, and district contact numbers.
Example JSON ResponseContent-Type: application/json
{
"status": "success",
"totalInmates": 4120,
"data": [...]
}GET
/api/roadsFetch active road closures, landslide blockages, and traffic advisories.
Example JSON ResponseContent-Type: application/json
{
"status": "success",
"data": [...]
}