Skip to main content
GET
Flood / River Discharge
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.