> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Flood / River Discharge

> GloFAS river discharge forecast and historical data with ensemble statistics.

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.


## OpenAPI

````yaml openapi/openmeteo.json GET /openmeteo/flood
openapi: 3.0.3
info:
  title: Open-Meteo Weather API
  version: 1.0.0
  description: >-
    Open-Meteo weather data routed through the AIsa gateway: forecast,
    historical, air quality, marine, ensemble, seasonal, climate, flood,
    geocoding and elevation. All endpoints are GET pass-through to Open-Meteo
    (open-meteo.com); AIsa handles provider access. Flat pricing of $0.00015 per
    call (150 micros USD), metered per request.
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - BearerAuth: []
paths:
  /openmeteo/flood:
    get:
      summary: Flood / River Discharge
      description: >-
        GloFAS river discharge forecast and historical data. Returns daily
        discharge statistics (mean, median, percentiles, min/max). GET
        pass-through to `https://flood-api.open-meteo.com/v1/flood`.


        Billed $0.00015 per call, metered per request.
      operationId: get_openmeteo_flood
      parameters:
        - name: latitude
          in: query
          required: true
          description: >-
            WGS84 latitude of the location. Multiple coordinates can be
            comma-separated.
          schema:
            type: string
            example: '52.52'
        - name: longitude
          in: query
          required: true
          description: >-
            WGS84 longitude of the location (negative for the Americas).
            Multiple coordinates can be comma-separated.
          schema:
            type: string
            example: '13.41'
        - name: daily
          in: query
          required: false
          description: >-
            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`.
          schema:
            type: string
            example: river_discharge,river_discharge_mean
        - name: forecast_days
          in: query
          required: false
          description: Number of forecast days to return (0-210). Default 92.
          schema:
            type: integer
            default: 92
            example: 7
        - name: past_days
          in: query
          required: false
          description: Number of past days to include (0-92). Default 0.
          schema:
            type: integer
            default: 0
        - name: start_date
          in: query
          required: false
          description: Start of the interval, `yyyy-mm-dd` (ISO 8601).
          schema:
            type: string
            example: '2024-01-01'
            format: date
        - name: end_date
          in: query
          required: false
          description: End of the interval, `yyyy-mm-dd` (ISO 8601).
          schema:
            type: string
            example: '2024-01-07'
            format: date
        - name: ensemble
          in: query
          required: false
          description: >-
            Return all ensemble members instead of the aggregate. Default
            `false`.
          schema:
            type: boolean
            default: false
        - name: timeformat
          in: query
          required: false
          description: Time output format. Default `iso8601`.
          schema:
            type: string
            enum:
              - iso8601
              - unixtime
            default: iso8601
        - name: models
          in: query
          required: false
          description: Comma-separated GloFAS models. Default best match.
          schema:
            type: string
            example: seamless_v4
        - name: cell_selection
          in: query
          required: false
          description: Grid-cell preference for the coordinate. Default `nearest`.
          schema:
            type: string
            enum:
              - land
              - sea
              - nearest
            default: nearest
      responses:
        '200':
          description: River discharge for the interval.
          content:
            application/json:
              schema:
                type: object
              example:
                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
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: AISA API Key

````