Flood advisories

PAGASA's General Flood Advisories.

Request

GET /v1/history/flood-advisories

curl "https://tubig-api.rjhon.net/v1/history/flood-advisories?limit=2"

5 calls a minute per visitor. Follow next for more.

Parameters

Name	In	Type	Default	What it does
`limit`	query	integer, 1 to 500	`100`	Items per call, at most 500
`cursor`	query	string or null		The cursor from a previous response's next link
`province`	query	string or null		A province as PAGASA names it, e.g. Bulacan
`from`	query	date (YYYY-MM-DD) or null		Manila date, YYYY-MM-DD
`to`	query	date (YYYY-MM-DD) or null		Manila date, YYYY-MM-DD

Response

An object with items (the fields below), next (the next page, or null) and sources (whom to credit).

Field	Type	What it is
`identifier`	string	PAGASA's CAP identifier
`sent`	datetime (UTC, ISO 8601)	When PAGASA sent it (UTC)
`expires`	datetime (UTC, ISO 8601) or null	When it expires (UTC)
`event`	string	PAGASA's event name, with its severity
`severity`	string or null	PAGASA's CAP severity
`state`	string	In force, Expired, Superseded or All clear, as of the call
`provinces`	list of string	The provinces it covers
`rivers`	map of string to string	The rivers PAGASA names, per province
`headline`	string or null	PAGASA's headline
`url`	string	The advisory's CAP file

Live example

Open in the browser

The first 2 items of what Tubig holds now.

{
  "items": [
    {
      "identifier": "56eb33d2-67ac-40f5-8b2e-1796515f20c8",
      "sent": "2026-10-01T09:57:15Z",
      "expires": "2026-10-01T21:57:15Z",
      "event": "General Flood Advisory (Moderate)",
      "severity": "Moderate",
      "state": "Expired",
      "provinces": [
        "Davao Oriental",
        "Davao Del Norte",
        "Davao Del Sur",
        "Davao De Oro"
      ],
      "rivers": {
        "Davao Oriental": "Rivers and its tributaries particularly Cateel, Dapnan, Baganga Mahan-ub, Manorigao, Caraga, Casaunan, Quinonoan, Bagwan, Mayo, Bitanayan, Sumlog, Tangmoan, Dacongbonwa, Kabasagan, Manay, Maya and Sumlao/Cuabo",
        "Davao Del Norte": "Rivers and its tributaries particularly Tagum-Libuganon, Tuganay, and Saug.",
        "Davao Occidental": "Rivers and its tributaries particularly Panglan, Malita, Batanan (Lais, Lawan, Latuan, Calian, Lamita, Lawayon, Culaman, Caburan Big, Meybio, Carahayan, Tubayon, Kayapung, Malala, Capisolo, Tanoman Bi, Tanoman Smal, Kalbay, Butuan, Nuing, Butula, Bukid, Malagupo, Balagona, Batulaki",
        "Davao Del Sur": "Rivers and its tributaries particularly Davao, Lasang, Bunawan, Matina, Talomo, Lipadas, Tagulaya Sibulan, Digos, and Padada Mainit.",
        "Davao De Oro": "Rivers and its tributaries particularly Matiao, Hijo, Agusan, and Manat."
      },
      "headline": "General Flood Advisory",
      "url": "https://publicalert.pagasa.dost.gov.ph/output/gfa/56eb33d2-67ac-40f5-8b2e-1796515f20c8.cap"
    },
    {
      "identifier": "476f52c4-5aab-4c4d-92e7-f6192ab2ad2c",
      "sent": "2026-10-01T09:55:59Z",
      "expires": "2026-10-01T21:55:59Z",
      "event": "General Flood Advisory (Moderate)",
      "severity": "Moderate",
      "state": "Expired",
      "provinces": [
        "Surigao Del Norte",
        "Agusan Del Norte",
        "Surigao Del Sur",
        "Dinagat Islands",
        "Agusan Del Sur"
      ],
      "rivers": {
        "Surigao Del Norte": "Rivers and its tributaries particularly Surigao and Magallanes.",
        "Agusan Del Norte": "Rivers and its tributaries particularly Lake-Mainit-Tubay, Asiga, Agusan, Linugos, Cabadbaran, and Agusan.",
        "Surigao Del Sur": "Rivers and its tributaries particularly Cantilan, Carac-An, Tandag, Tago, Hubo-Oteiza, Hinatuan, Bislig, and Agusan.",
        "Dinagat Islands": "Rivers and its tributaries particularly Malinao Inlet and Gaas Lulet.",
        "Agusan Del Sur": "Rivers and its tributaries particularly Ojot, Wawa, Libang, Maosam, Kasilan, Gibong, Adgaoan, Simulao, Kayonan and Andanan."
      },
      "headline": "General Flood Advisory",
      "url": "https://publicalert.pagasa.dost.gov.ph/output/gfa/476f52c4-5aab-4c4d-92e7-f6192ab2ad2c.cap"
    }
  ],
  "next": "/v1/history/flood-advisories?limit=2&cursor=WyJkYXRldGltZSIsICIyMDI2LTEwLTAxVDA5OjU1OjU5KzAwOjAwIiwgIjQ3NmY1MmM0LTVhYWItNGM0ZC05MmU3LWY2MTkyYWIyYWQyYyJd",
  "sources": [
    {
      "name": "PAGASA public alerts (CAP)",
      "url": "https://publicalert.pagasa.dost.gov.ph/feeds/",
      "licence": "CC BY 4.0"
    }
  ]
}