Open-Meteo Ensemble

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
  --url 'https://api.aisa.one/apis/v1/openmeteo/ensemble?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/ensemble', 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/ensemble",
  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/ensemble"

	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/ensemble")

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

{
  "elevation": 38,
  "generationtime_ms": 2.1,
  "hourly": {
    "temperature_2m_member01": [
      2.1
    ],
    "temperature_2m_member02": [
      2.4
    ],
    "temperature_2m_member03": [
      1.8
    ],
    "time": [
      "2024-01-01T00:00"
    ]
  },
  "hourly_units": {
    "temperature_2m": "°C",
    "time": "iso8601"
  },
  "latitude": 52.5,
  "longitude": 13.4,
  "timezone": "GMT",
  "utc_offset_seconds": 0
}

GET

https://api.aisa.one

apis

openmeteo

ensemble

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
  --url 'https://api.aisa.one/apis/v1/openmeteo/ensemble?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/ensemble', 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/ensemble",
  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/ensemble"

	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/ensemble")

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

{
  "elevation": 38,
  "generationtime_ms": 2.1,
  "hourly": {
    "temperature_2m_member01": [
      2.1
    ],
    "temperature_2m_member02": [
      2.4
    ],
    "temperature_2m_member03": [
      1.8
    ],
    "time": [
      "2024-01-01T00:00"
    ]
  },
  "hourly_units": {
    "temperature_2m": "°C",
    "time": "iso8601"
  },
  "latitude": 52.5,
  "longitude": 13.4,
  "timezone": "GMT",
  "utc_offset_seconds": 0
}

Fetch probabilistic ensemble forecasts for spread and probability analysis. models is optional — omit it to get the default best-match global ensemble (a 30-member set), or pass a comma-separated list such as icon_seamless, gfs_seamless, ecmwf_ifs025 or gem_global; each model exposes its own number of members. Request variables with hourly and/or daily lists. Every requested variable is returned once per ensemble member, suffixed with the member index (e.g. temperature_2m_member01, temperature_2m_member02, …), alongside grid-cell metadata, a shared time array and a *_units object. Example:

GET /apis/v1/openmeteo/ensemble?latitude=52.52&longitude=13.41&hourly=temperature_2m,wind_speed_10m&models=icon_seamless&forecast_days=7

. 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/ensemble
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/openmeteo/ensemble
cell_selection: query; optional
daily: query; optional
elevation: query; optional
end_date: query; optional
forecast_days: query; optional
hourly: query; optional
latitude: query; required
longitude: query; required
models: query; optional
past_days: query; optional
precipitation_unit: query; optional
start_date: query; optional
temperature_unit: query; optional
timeformat: query; optional
timezone: query; optional
wind_speed_unit: query; optional
Runtime facts: sha256:36f55c225a89aa6e29290270a8eeed85c6f6224160884d7fa3a086ea2ad602ef

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

{
  "operationId": "get_openmeteo_ensemble",
  "method": "GET",
  "path": "/apis/v1/openmeteo/ensemble",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "description": "Grid-cell preference for the coordinate. Default `land`.",
      "in": "query",
      "name": "cell_selection",
      "required": false,
      "schema": {
        "default": "land",
        "enum": [
          "land",
          "sea",
          "nearest"
        ],
        "type": "string"
      }
    },
    {
      "description": "Comma-separated list of daily aggregation variables to return. Requires `timezone`. Common values: `temperature_2m_max`, `temperature_2m_min`, `temperature_2m_mean`, `precipitation_sum`, `rain_sum`, `snowfall_sum`, `weather_code`, `sunrise`, `sunset`, `sunshine_duration`, `wind_speed_10m_max`, `uv_index_max`.",
      "in": "query",
      "name": "daily",
      "required": false,
      "schema": {
        "example": "temperature_2m_max,precipitation_sum",
        "type": "string"
      }
    },
    {
      "description": "Manual elevation (meters). Defaults to a 90m DEM.",
      "in": "query",
      "name": "elevation",
      "required": false,
      "schema": {
        "example": "38",
        "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": "Number of forecast days to return (0-35). Default 7.",
      "in": "query",
      "name": "forecast_days",
      "required": false,
      "schema": {
        "default": 7,
        "example": 7,
        "type": "integer"
      }
    },
    {
      "description": "Comma-separated list of hourly variables to return. Common values: `temperature_2m`, `relative_humidity_2m`, `dew_point_2m`, `apparent_temperature`, `precipitation`, `rain`, `showers`, `snowfall`, `weather_code`, `pressure_msl`, `cloud_cover`, `wind_speed_10m`, `wind_direction_10m`, `wind_gusts_10m`, `shortwave_radiation`, `visibility`. Also `cape`.",
      "in": "query",
      "name": "hourly",
      "required": false,
      "schema": {
        "example": "temperature_2m,wind_speed_10m",
        "type": "string"
      }
    },
    {
      "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": "Optional; when omitted, defaults to the best-match global ensemble (a 30-member set). Comma-separated ensemble models, e.g. `icon_seamless`, `gfs_seamless`, `ecmwf_ifs025`, `gem_global`. Each model exposes its own member count.",
      "in": "query",
      "name": "models",
      "required": false,
      "schema": {
        "example": "icon_seamless",
        "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": "Precipitation unit. Default `mm`.",
      "in": "query",
      "name": "precipitation_unit",
      "required": false,
      "schema": {
        "default": "mm",
        "enum": [
          "mm",
          "inch"
        ],
        "type": "string"
      }
    },
    {
      "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": "Temperature unit. Default `celsius`.",
      "in": "query",
      "name": "temperature_unit",
      "required": false,
      "schema": {
        "default": "celsius",
        "enum": [
          "celsius",
          "fahrenheit"
        ],
        "type": "string"
      }
    },
    {
      "description": "Time output format. Default `iso8601`.",
      "in": "query",
      "name": "timeformat",
      "required": false,
      "schema": {
        "default": "iso8601",
        "enum": [
          "iso8601",
          "unixtime"
        ],
        "type": "string"
      }
    },
    {
      "description": "IANA time zone name (e.g. `Europe/Berlin`) or `auto` to resolve from coordinates. Defaults to `GMT`.",
      "in": "query",
      "name": "timezone",
      "required": false,
      "schema": {
        "example": "Europe/Berlin",
        "type": "string"
      }
    },
    {
      "description": "Wind speed unit. Default `kmh`.",
      "in": "query",
      "name": "wind_speed_unit",
      "required": false,
      "schema": {
        "default": "kmh",
        "enum": [
          "kmh",
          "ms",
          "mph",
          "kn"
        ],
        "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:land

Grid-cell preference for the coordinate. Default land.

Available options:

land,

sea,

nearest

daily

string

Comma-separated list of daily aggregation variables to return. Requires timezone. Common values: temperature_2m_max, temperature_2m_min, temperature_2m_mean, precipitation_sum, rain_sum, snowfall_sum, weather_code, sunrise, sunset, sunshine_duration, wind_speed_10m_max, uv_index_max.

Example:

"temperature_2m_max,precipitation_sum"

elevation

string

Manual elevation (meters). Defaults to a 90m DEM.

Example:

"38"

end_date

string<date>

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

Example:

"2024-01-07"

forecast_days

integer

default:7

Number of forecast days to return (0-35). Default 7.

Example:

7

hourly

string

Comma-separated list of hourly variables to return. Common values: temperature_2m, relative_humidity_2m, dew_point_2m, apparent_temperature, precipitation, rain, showers, snowfall, weather_code, pressure_msl, cloud_cover, wind_speed_10m, wind_direction_10m, wind_gusts_10m, shortwave_radiation, visibility. Also cape.

Example:

"temperature_2m,wind_speed_10m"

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

Optional; when omitted, defaults to the best-match global ensemble (a 30-member set). Comma-separated ensemble models, e.g. icon_seamless, gfs_seamless, ecmwf_ifs025, gem_global. Each model exposes its own member count.

Example:

"icon_seamless"

past_days

integer

default:0

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

precipitation_unit

enum<string>

default:mm

Precipitation unit. Default mm.

Available options:

mm,

inch

start_date

string<date>

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

Example:

"2024-01-01"

temperature_unit

enum<string>

default:celsius

Temperature unit. Default celsius.

Available options:

celsius,

fahrenheit

timeformat

enum<string>

default:iso8601

Time output format. Default iso8601.

Available options:

iso8601,

unixtime

timezone

string

IANA time zone name (e.g. Europe/Berlin) or auto to resolve from coordinates. Defaults to GMT.

Example:

"Europe/Berlin"

wind_speed_unit

enum<string>

default:kmh

Wind speed unit. Default kmh.

Available options:

kmh,

ms,

mph,

kn

Response

Ensemble forecast with per-member arrays.

The response is of type object.

Overview

Models

Search & Research

Finance & Crypto

Social & Media

SEO & Web Intel

Sales & Email

Travel & Other

Open-Meteo Ensemble

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