Flood / River Discharge

GloFAS river discharge forecast and historical data with ensemble statistics.

GET https://api.aisa.one/apis/v1/openmeteo/flood

Flood / River Discharge

cURL

curl --request GET \
  --url https://api.aisa.one/apis/v1/openmeteo/flood \
  --header 'Authorization: Bearer <token>'

200

{
  "latitude": 59.9,
  "longitude": 10.75,
  "generationtime_ms": 0.4,
  "timezone": "GMT",
  "daily_units": {
    "time": "iso8601",
    "river_discharge": "m³/s",
    "river_discharge_mean": "m³/s"
  },
  "daily": {
    "time": [
      "2024-01-01",
      "2024-01-02"
    ],
    "river_discharge": [
      122.4,
      118.9
    ],
    "river_discharge_mean": [
      120.1,
      117.5
    ]
  }
}

Fetch GloFAS river-discharge forecast and historical data for a coordinate. Request daily discharge statistics such as river_discharge, river_discharge_mean, river_discharge_median, river_discharge_max, river_discharge_min, river_discharge_p25, river_discharge_p75. Control the horizon with forecast_days (up to 210) and past_days, or an explicit start_date/end_date; set ensemble=true to return all members.

The response returns grid-cell metadata and a daily block with a time array, one array per variable (m³/s), and a matching daily_units object.

Example: GET /apis/v1/openmeteo/flood?latitude=59.91&longitude=10.75&daily=river_discharge,river_discharge_mean&forecast_days=30.

Billing: $0.00015 per call (150 micros USD), metered per request. All Open-Meteo endpoints are GET pass-through — authenticate with your AIsa API key as a bearer token (the same key used across every AIsa /apis/* endpoint); AIsa handles provider access.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

latitude · string · required

WGS84 latitude of the location. Multiple coordinates can be comma-separated.

Example:

"52.52"

longitude · string · required

WGS84 longitude of the location (negative for the Americas). Multiple coordinates can be comma-separated.

Example:

"13.41"

daily · string

Comma-separated list of daily aggregation variables to return. Requires timezone. Common values: river_discharge, river_discharge_mean, river_discharge_median, river_discharge_max, river_discharge_min, river_discharge_p25, river_discharge_p75.

Example:

"river_discharge,river_discharge_mean"

forecast_days · integer · default: 92

Number of forecast days to return (0-210). Default 92.

Example:

7

past_days · integer · default: 0

Number of past days to include (0-92). Default 0.

start_date · string<date>

Start of the interval, yyyy-mm-dd (ISO 8601).

Example:

"2024-01-01"

end_date · string<date>

End of the interval, yyyy-mm-dd (ISO 8601).

Example:

"2024-01-07"

ensemble · boolean · default: false

Return all ensemble members instead of the aggregate. Default false.

timeformat · enum<string> · default: iso8601

Time output format. Default iso8601.

Available options: iso8601, unixtime

models · string

Comma-separated GloFAS models. Default best match.

Example:

"seamless_v4"

cell_selection · enum<string> · default: nearest

Grid-cell preference for the coordinate. Default nearest.

Available options: land, sea, nearest

Response

200 - application/json

River discharge for the interval.

The response is of type object.