Open-Meteo Flood

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
  --url 'https://api.aisa.one/apis/v1/openmeteo/flood?latitude=52.52&longitude=13.41' \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/openmeteo/flood', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/openmeteo/flood",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/openmeteo/flood"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/openmeteo/flood")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

GET

https://api.aisa.one

apis

openmeteo

flood

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
  --url 'https://api.aisa.one/apis/v1/openmeteo/flood?latitude=52.52&longitude=13.41' \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/openmeteo/flood', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/openmeteo/flood",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/openmeteo/flood"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/openmeteo/flood")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

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: per call, metered per request. Current prices are on aisa.one/api. 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.

Request contract

Method and path: GET /apis/v1/openmeteo/flood
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/openmeteo/flood
cell_selection: query; optional
daily: query; optional
end_date: query; optional
ensemble: query; optional
forecast_days: query; optional
latitude: query; required
longitude: query; required
models: query; optional
past_days: query; optional
start_date: query; optional
timeformat: query; optional
Runtime facts: sha256:36f55c225a89aa6e29290270a8eeed85c6f6224160884d7fa3a086ea2ad602ef

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "get_openmeteo_flood",
  "method": "GET",
  "path": "/apis/v1/openmeteo/flood",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "description": "Grid-cell preference for the coordinate. Default `nearest`.",
      "in": "query",
      "name": "cell_selection",
      "required": false,
      "schema": {
        "default": "nearest",
        "enum": [
          "land",
          "sea",
          "nearest"
        ],
        "type": "string"
      }
    },
    {
      "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`.",
      "in": "query",
      "name": "daily",
      "required": false,
      "schema": {
        "example": "river_discharge,river_discharge_mean",
        "type": "string"
      }
    },
    {
      "description": "End of the interval, `yyyy-mm-dd` (ISO 8601).",
      "in": "query",
      "name": "end_date",
      "required": false,
      "schema": {
        "example": "2024-01-07",
        "format": "date",
        "type": "string"
      }
    },
    {
      "description": "Return all ensemble members instead of the aggregate. Default `false`.",
      "in": "query",
      "name": "ensemble",
      "required": false,
      "schema": {
        "default": false,
        "type": "boolean"
      }
    },
    {
      "description": "Number of forecast days to return (0-210). Default 92.",
      "in": "query",
      "name": "forecast_days",
      "required": false,
      "schema": {
        "default": 92,
        "example": 7,
        "type": "integer"
      }
    },
    {
      "description": "WGS84 latitude of the location. Multiple coordinates can be comma-separated.",
      "in": "query",
      "name": "latitude",
      "required": true,
      "schema": {
        "example": "52.52",
        "type": "string"
      }
    },
    {
      "description": "WGS84 longitude of the location (negative for the Americas). Multiple coordinates can be comma-separated.",
      "in": "query",
      "name": "longitude",
      "required": true,
      "schema": {
        "example": "13.41",
        "type": "string"
      }
    },
    {
      "description": "Comma-separated GloFAS models. Default best match.",
      "in": "query",
      "name": "models",
      "required": false,
      "schema": {
        "example": "seamless_v4",
        "type": "string"
      }
    },
    {
      "description": "Number of past days to include (0-92). Default 0.",
      "in": "query",
      "name": "past_days",
      "required": false,
      "schema": {
        "default": 0,
        "type": "integer"
      }
    },
    {
      "description": "Start of the interval, `yyyy-mm-dd` (ISO 8601).",
      "in": "query",
      "name": "start_date",
      "required": false,
      "schema": {
        "example": "2024-01-01",
        "format": "date",
        "type": "string"
      }
    },
    {
      "description": "Time output format. Default `iso8601`.",
      "in": "query",
      "name": "timeformat",
      "required": false,
      "schema": {
        "default": "iso8601",
        "enum": [
          "iso8601",
          "unixtime"
        ],
        "type": "string"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "fixed_success",
    "customer_pricing": "fixed_success",
    "default_request_estimate_usd": 0.0001,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Published reference price: $0.0001 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Default request reference estimate (USD): 0.0001
Cost contract: fixed_success
Settlement evidence source: request_snapshot

Authorizations

Authorization

string

header

required

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

Query Parameters

cell_selection

enum<string>

default:nearest

Grid-cell preference for the coordinate. Default nearest.

Available options:

land,

sea,

nearest

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"

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.

forecast_days

integer

default:92

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

Example:

7

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"

models

string

Comma-separated GloFAS models. Default best match.

Example:

"seamless_v4"

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"

timeformat

enum<string>

default:iso8601

Time output format. Default iso8601.

Available options:

iso8601,

unixtime

Response

River discharge for the interval.

The response is of type object.

Overview

Models

Search & Research

Finance & Crypto

Social & Media

SEO & Web Intel

Sales & Email

Travel & Other

Open-Meteo Flood

Request contract

Cost and request rules

Authorizations

Query Parameters

Response

​Request contract

​Cost and request rules

Authorizations

Query Parameters

Response

Request contract

Cost and request rules