River readings

Every reading kept for one river gauge.

Request

GET /v1/history/rivers/{code}/readings

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

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

Parameters

Name	In	Type	Default	What it does
`code`required	path	string		A river gauge's code from /v1/history/rivers
`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 or null	Water level, metres
`unconfirmed`	true or false	True when the feed marks the reading (*)
`level_30m_before_m`	number or null	The level 30 minutes earlier, as the feed gives it
`level_1h_before_m`	number or null	The level an hour earlier
`level_2h_before_m`	number or null	The level two hours earlier

Live example

Open in the browser

The first 2 items of what Tubig holds now.

{
  "items": [
    {
      "observed_at": "2026-10-02T21:00:00Z",
      "level_m": 12.2,
      "unconfirmed": true,
      "level_30m_before_m": 12.21,
      "level_1h_before_m": 12.21,
      "level_2h_before_m": 12.2
    },
    {
      "observed_at": "2026-10-02T20:40:00Z",
      "level_m": 12.21,
      "unconfirmed": true,
      "level_30m_before_m": 12.21,
      "level_1h_before_m": 12.2,
      "level_2h_before_m": 12.2
    }
  ],
  "next": "/v1/history/rivers/11105201/readings?limit=2&cursor=WyJkYXRldGltZSIsICIyMDI2LTEwLTAyVDIwOjQwOjAwKzAwOjAwIiwgNDYzNF0",
  "sources": [
    {
      "name": "PAGASA Pasig-Marikina-Tullahan flood forecasting and warning system",
      "url": "https://pasig-marikina-tullahanffws.pagasa.dost.gov.ph/",
      "licence": null
    }
  ]
}