API Docs

Developer Integration API

Jalam? is built with open integration in mind. Volunteer networks, emergency squads, and developers can access public read-only JSON endpoints to build notification channels, maps, and widgets.

GET/api/reports

Retrieve active flood pins (last 6 hours) and latest water supply status per area.

// Query Parameters: ?type=supply | ?type=flood

{
  "success": true,
  "flood": [
    {
      "id": "rep-f-1",
      "lat": 10.1082,
      "lng": 76.3510,
      "road_or_landmark": "Aluva NH Bypass Metro Pillar 32",
      "district": "Ernakulam",
      "severity": "flooded_impassable",
      "note": "Water level high, avoid route."
    }
  ]
}

GET/api/districts

Retrieve aggregated water supply health percentage and active flood incident counts for all 14 districts in Kerala.

{
  "success": true,
  "districts": [
    {
      "district": "Ernakulam",
      "totalAreas": 4,
      "availableAreas": 3,
      "healthPercentage": 75,
      "activeFloodsCount": 2
    }
  ]
}

Rate Limits & Decay Policies

Water Outages: Limited to 1 report per device / area per 10 minutes.
Flood Pins: Limited to 1 report per device / 200m radius per 30 minutes.
Flood Decay: Pins automatically disappear from the live map 6 hours after reports are filed unless re-reported or updated.