Method: floodStatus.queryLatestFloodStatusByGaugeIds

  • The latest flood status for a list of gauge ids can be queried using an HTTP GET request.

  • The query requires a list of gauge IDs as a query parameter, with a size limit of 20,000.

  • The request body must be empty.

  • The response body contains an array of FloodStatus objects for the requested gauges.

Query latest flood status by gauge ids.

HTTP request

GET https://floodforecasting.googleapis.com/v1/floodStatus:queryLatestFloodStatusByGaugeIds

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
gaugeIds[]

string

Required. A list of gauge ids. The supported list size is limited to 20,000. If a list larger than 20,000 is provided it fails with an INVALID_REQUEST error.
cutoffTime

string

Optional. Optional. The cutoff time for the flood statuses. When provided, the latest (last published) flood statuses as of the cut-off time will be returned. When not provided, the latest published flood statuses as of now will be returned. The minimum allowed cutoff time is 2025-08-01T00:00:00Z. If the cutoff time is before this time, an INVALID_ARGUMENT error will be returned. Represented as ISO 8601, e.g., "2025-10-17T10:34:00Z".

Request body

The request body must be empty.

Response body

The response of floodStatus.queryLatestFloodStatusByGaugeIds.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "floodStatuses": [
    {
      object (FloodStatus)
    }
  ]
}
Fields
floodStatuses[]

object (FloodStatus)

The latest flood statuses for the requested gauges.