Ensemble Models

Probabilistic ensemble weather forecasts with per-member arrays.

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

Ensemble Models

cURL

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

200

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

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: $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"

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"

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"

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"

forecast_days · integer · default: 7

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

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"

elevation · string

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

Example:

"38"

temperature_unit · enum<string> · default: celsius

Temperature unit. Default celsius.

Available options: celsius, fahrenheit

wind_speed_unit · enum<string> · default: kmh

Wind speed unit. Default kmh.

Available options: kmh, ms, mph, kn

precipitation_unit · enum<string> · default: mm

Precipitation unit. Default mm.

Available options: mm, inch

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"

cell_selection · enum<string> · default: land

Grid-cell preference for the coordinate. Default land.

Available options: land, sea, nearest

Response

200 - application/json

Ensemble forecast with per-member arrays.

The response is of type object.