Dam readings

Every reading kept for one dam.

Request

GET /v1/history/dams/{dam}/readings

curl "https://tubig-api.rjhon.net/v1/history/dams/angat/readings?limit=2"

5 calls a minute per visitor. Follow next for more. The example uses the first dam on record; list them with the endpoint above it.

Parameters

Name	In	Type	Default	What it does
`dam`required	path	string		A dam's id from /v1/history/dams, e.g. angat
`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
`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
`observed_at`	datetime (UTC, ISO 8601)	When the level was read (UTC)
`level_m`	number	Water level, metres above sea level
`rule_curve_m`	number or null	The rule curve level for the day, when PAGASA gives it
`normal_high_m`	number or null	The normal high water level, when given
`change_24h_m`	number or null	Change over 24 hours, as PAGASA gives it
`source`	string	Where the reading came from (pagasa_dams, seed, manual)

Live example

Open in the browser

The first 2 items of what Tubig holds now.

{
  "items": [
    {
      "observed_at": "2026-10-02T00:00:00Z",
      "level_m": 208.53,
      "rule_curve_m": 186.54,
      "normal_high_m": 210.0,
      "change_24h_m": -0.11,
      "source": "pagasa_dams"
    },
    {
      "observed_at": "2026-10-01T00:00:00Z",
      "level_m": 208.64,
      "rule_curve_m": 186.17,
      "normal_high_m": 210.0,
      "change_24h_m": null,
      "source": "pagasa_dams"
    }
  ],
  "next": "/v1/history/dams/angat/readings?limit=2&cursor=WyJkYXRldGltZSIsICIyMDI2LTEwLTAxVDAwOjAwOjAwKzAwOjAwIiwgNDRd",
  "sources": [
    {
      "name": "PAGASA, dam information",
      "url": "https://pagasa.dost.gov.ph/flood",
      "licence": null
    }
  ]
}