latitudestringrequired
WGS84 latitude of the location. Multiple coordinates can be comma-separated.
Open-Meteo Weather Forecast API docs
Open Playground →Start building
Send your first request
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/open-meteo/forecast" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"daily": "temperature_2m_max,temperature_2m_min,precipitation_sum",
"hourly": "temperature_2m,precipitation,wind_speed_10m",
"models": "auto",
"current": "temperature_2m,weather_code",
"end_date": "2024-01-07",
"latitude": "52.52",
"timezone": "Europe/Berlin",
"elevation": "38",
"longitude": "13.41",
"past_days": 0,
"start_date": "2024-01-01",
"timeformat": "iso8601",
"minutely_15": "temperature_2m,precipitation",
"forecast_days": 7,
"cell_selection": "land",
"wind_speed_unit": "kmh",
"temperature_unit": "celsius",
"precipitation_unit": "mm"
}
SANDBASE_JSON
)
printf '%s\n' "$result"2. Authentication
Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
3. Parameters
longitudestringrequired
WGS84 longitude of the location (negative for the Americas). Multiple coordinates can be comma-separated.
cell_selectionstring
Grid-cell preference for the coordinate. Default `land`.
Default: "land"
Possible values: land, sea, nearest
currentstring
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`.
dailystring
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_i
elevationstring
Manual elevation (meters) for statistical downscaling. Defaults to a 90m DEM. Use `nan` to disable downscaling.
end_datestring
End of the interval, `yyyy-mm-dd` (ISO 8601).
forecast_daysinteger
Number of forecast days to return (0-16). Default 7.
Default: 7
forecast_hoursinteger
Limit the forecast to a given number of hours from now.
hourlystring
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`
minutely_15string
Comma-separated 15-minutely variables (Central Europe & North America high-resolution models only).
modelsstring
Comma-separated forecast models to use. Default `auto` selects the best model mix per location.
past_daysinteger
Number of past days to include (0-92). Default 0.
Default: 0
past_hoursinteger
Include a given number of past hours.
precipitation_unitstring
Precipitation unit. Default `mm`.
Default: "mm"
Possible values: mm, inch
start_datestring
Start of the interval, `yyyy-mm-dd` (ISO 8601).
temperature_unitstring
Temperature unit. Default `celsius`.
Default: "celsius"
Possible values: celsius, fahrenheit
timeformatstring
Time output format. Default `iso8601`.
Default: "iso8601"
Possible values: iso8601, unixtime
timezonestring
IANA time zone name (e.g. `Europe/Berlin`) or `auto` to resolve from coordinates. Defaults to `GMT`.
wind_speed_unitstring
Wind speed unit. Default `kmh`.
Default: "kmh"
Possible values: kmh, ms, mph, kn
4. Response
Saved example response for this API; no live request is made when viewing it.
No saved response has been published. Run the API in Playground to inspect its response.