Open-Meteo Forecast

Reference example

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

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

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

{
  "current": {
    "interval": 900,
    "temperature_2m": 4.5,
    "time": "2024-01-01T12:00",
    "weather_code": 3
  },
  "current_units": {
    "interval": "seconds",
    "temperature_2m": "°C",
    "time": "iso8601",
    "weather_code": "wmo code"
  },
  "daily": {
    "precipitation_sum": [
      0.4
    ],
    "temperature_2m_max": [
      5.2
    ],
    "temperature_2m_min": [
      1.1
    ],
    "time": [
      "2024-01-01"
    ]
  },
  "daily_units": {
    "precipitation_sum": "mm",
    "temperature_2m_max": "°C",
    "temperature_2m_min": "°C",
    "time": "iso8601"
  },
  "elevation": 38,
  "generationtime_ms": 0.19,
  "hourly": {
    "precipitation": [
      0,
      0.1
    ],
    "temperature_2m": [
      2.1,
      1.9
    ],
    "time": [
      "2024-01-01T00:00",
      "2024-01-01T01:00"
    ],
    "wind_speed_10m": [
      11.2,
      10.4
    ]
  },
  "hourly_units": {
    "precipitation": "mm",
    "temperature_2m": "°C",
    "time": "iso8601",
    "wind_speed_10m": "km/h"
  },
  "latitude": 52.52,
  "longitude": 13.419998,
  "timezone": "Europe/Berlin",
  "timezone_abbreviation": "CEST",
  "utc_offset_seconds": 7200
}

GET

https://api.aisa.one

apis

openmeteo

forecast

Reference example

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

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

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

{
  "current": {
    "interval": 900,
    "temperature_2m": 4.5,
    "time": "2024-01-01T12:00",
    "weather_code": 3
  },
  "current_units": {
    "interval": "seconds",
    "temperature_2m": "°C",
    "time": "iso8601",
    "weather_code": "wmo code"
  },
  "daily": {
    "precipitation_sum": [
      0.4
    ],
    "temperature_2m_max": [
      5.2
    ],
    "temperature_2m_min": [
      1.1
    ],
    "time": [
      "2024-01-01"
    ]
  },
  "daily_units": {
    "precipitation_sum": "mm",
    "temperature_2m_max": "°C",
    "temperature_2m_min": "°C",
    "time": "iso8601"
  },
  "elevation": 38,
  "generationtime_ms": 0.19,
  "hourly": {
    "precipitation": [
      0,
      0.1
    ],
    "temperature_2m": [
      2.1,
      1.9
    ],
    "time": [
      "2024-01-01T00:00",
      "2024-01-01T01:00"
    ],
    "wind_speed_10m": [
      11.2,
      10.4
    ]
  },
  "hourly_units": {
    "precipitation": "mm",
    "temperature_2m": "°C",
    "time": "iso8601",
    "wind_speed_10m": "km/h"
  },
  "latitude": 52.52,
  "longitude": 13.419998,
  "timezone": "Europe/Berlin",
  "timezone_abbreviation": "CEST",
  "utc_offset_seconds": 7200
}

Fetch a weather forecast for any WGS84 coordinate from Open-Meteo’s blended high-resolution model mix. Choose the fields you want with hourly, daily and current (comma-separated variable lists) — e.g. temperature_2m, precipitation, wind_speed_10m for hourly, or temperature_2m_max/precipitation_sum for daily. Control the horizon with forecast_days (up to 16) and past_days, and set timezone=auto to localize daily aggregates. The response returns the resolved grid-cell latitude/longitude/elevation, timezone metadata, and a block per requested resolution (hourly, daily, current) each with a parallel time array plus one array per variable, alongside a matching *_units object. Example:

GET /apis/v1/openmeteo/forecast?latitude=52.52&longitude=13.41&hourly=temperature_2m,precipitation&daily=temperature_2m_max,temperature_2m_min&current=temperature_2m,weather_code&timezone=Europe/Berlin

. 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/forecast
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/openmeteo/forecast
cell_selection: query; optional
current: query; optional
daily: query; optional
elevation: query; optional
end_date: query; optional
forecast_days: query; optional
forecast_hours: query; optional
hourly: query; optional
latitude: query; required
longitude: query; required
minutely_15: query; optional
models: query; optional
past_days: query; optional
past_hours: 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_forecast",
  "method": "GET",
  "path": "/apis/v1/openmeteo/forecast",
  "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 current-condition variables to return. Common values: `temperature_2m`, `relative_humidity_2m`, `apparent_temperature`, `is_day`, `precipitation`, `weather_code`, `wind_speed_10m`, `wind_direction_10m`.",
      "in": "query",
      "name": "current",
      "required": false,
      "schema": {
        "example": "temperature_2m,weather_code",
        "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,temperature_2m_min,precipitation_sum",
        "type": "string"
      }
    },
    {
      "description": "Manual elevation (meters) for statistical downscaling. Defaults to a 90m DEM. Use `nan` to disable downscaling.",
      "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-16). Default 7.",
      "in": "query",
      "name": "forecast_days",
      "required": false,
      "schema": {
        "default": 7,
        "example": 7,
        "type": "integer"
      }
    },
    {
      "description": "Limit the forecast to a given number of hours from now.",
      "in": "query",
      "name": "forecast_hours",
      "required": false,
      "schema": {
        "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`.",
      "in": "query",
      "name": "hourly",
      "required": false,
      "schema": {
        "example": "temperature_2m,precipitation,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": "Comma-separated 15-minutely variables (Central Europe & North America high-resolution models only).",
      "in": "query",
      "name": "minutely_15",
      "required": false,
      "schema": {
        "example": "temperature_2m,precipitation",
        "type": "string"
      }
    },
    {
      "description": "Comma-separated forecast models to use. Default `auto` selects the best model mix per location.",
      "in": "query",
      "name": "models",
      "required": false,
      "schema": {
        "example": "auto",
        "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": "Include a given number of past hours.",
      "in": "query",
      "name": "past_hours",
      "required": false,
      "schema": {
        "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

current

string

Comma-separated list of current-condition variables to return. Common values: temperature_2m, relative_humidity_2m, apparent_temperature, is_day, precipitation, weather_code, wind_speed_10m, wind_direction_10m.

Example:

"temperature_2m,weather_code"

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,temperature_2m_min,precipitation_sum"

elevation

string

Manual elevation (meters) for statistical downscaling. Defaults to a 90m DEM. Use nan to disable downscaling.

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-16). Default 7.

Example:

7

forecast_hours

integer

Limit the forecast to a given number of hours from now.

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.

Example:

"temperature_2m,precipitation,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"

minutely_15

string

Comma-separated 15-minutely variables (Central Europe & North America high-resolution models only).

Example:

"temperature_2m,precipitation"

models

string

Comma-separated forecast models to use. Default auto selects the best model mix per location.

Example:

"auto"

past_days

integer

default:0

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

past_hours

integer

Include a given number of past hours.

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

Requested weather forecast for the coordinate.

The response is of type object.

Overview

Models

Search & Research

Finance & Crypto

Social & Media

SEO & Web Intel

Sales & Email

Travel & Other

Open-Meteo Forecast

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