Returns up to 16-day hourly and daily weather forecasts for any global location using coordinates, blending multiple national weather models automatically or allowing manual model selection, with no API key required for non-commercial use.
openapi: '3.0.3'
info:
title: Open-Meteo Weather Forecast API
description: >-
Open-Meteo offers free weather forecast APIs for open-source developers and non-commercial use.
version: '1.0'
contact:
name: Open-Meteo
url: https://open-meteo.com
email: [email protected]
license:
name: Attribution 4.0 International (CC BY 4.0)
url: https://creativecommons.org/licenses/by/4.0/
termsOfService: https://open-meteo.com/en/features#terms
paths:
/v1/forecast:
servers:
- url: https://api.open-meteo.com
- url: https://customer-api.open-meteo.com
get:
tags:
- Weather Forecast APIs
summary: Open-Meteo Weather Forecast API
description: >-
Open-Meteo offers free weather forecast APIs for open-source developers and non-commercial use.
parameters:
- name: latitude
in: query
required: true
description: >-
Geographical WGS84 coordinates. Multiple coordinates can be comma separated.
schema:
type: string
- name: longitude
in: query
required: true
schema:
type: string
- name: hourly
in: query
description: >-
A list of weather variables which should be returned.
explode: false
schema:
type: array
items:
type: string
enum:
- temperature_2m
- temperature_2m_min
- temperature_2m_max
- relative_humidity_2m
- dew_point_2m
- apparent_temperature
- precipitation_probability
- precipitation
- rain
- showers
- snowfall
- snow_depth
- snowfall_water_equivalent
- snow_depth_water_equivalent
- weather_code
- pressure_msl
- surface_pressure
- cloud_cover
- cloud_cover_low
- cloud_cover_mid
- cloud_cover_high
- visibility
- evapotranspiration
- et0_fao_evapotranspiration
- vapour_pressure_deficit
- runoff
- precipitation_type
- rain_probability
- snowfall_probability
- freezing_rain_probability
- ice_pellets_probability
- thunderstorm_probability
- wind_speed_10m
- wind_speed_20m
- wind_speed_30m
- wind_speed_40m
- wind_speed_50m
- wind_speed_70m
- wind_speed_80m
- wind_speed_100m
- wind_speed_120m
- wind_speed_140m
- wind_speed_150m
- wind_speed_160m
- wind_speed_180m
- wind_speed_200m
- wind_direction_10m
- wind_direction_20m
- wind_direction_30m
- wind_direction_40m
- wind_direction_50m
- wind_direction_70m
- wind_direction_80m
- wind_direction_100m
- wind_direction_120m
- wind_direction_140m
- wind_direction_150m
- wind_direction_160m
- wind_direction_180m
- wind_direction_200m
- wind_gusts_10m
- temperature_20m
- temperature_40m
- temperature_50m
- temperature_80m
- temperature_100m
- temperature_120m
- temperature_150m
- temperature_180m
- temperature_200m
- soil_temperature_0cm
- soil_temperature_6cm
- soil_temperature_18cm
- soil_temperature_54cm
- soil_temperature_162cm
- soil_temperature_486cm
- soil_temperature_1458cm
- soil_temperature_0_to_7cm
- soil_temperature_7_to_28cm
- soil_temperature_28_to_100cm
- soil_temperature_100_to_255cm
- soil_temperature_0_to_10cm
- soil_temperature_10_to_40cm
- soil_temperature_40_to_100cm
- soil_temperature_100_to_200cm
- soil_temperature_10_to_35cm
- soil_temperature_35_to_100cm
- soil_temperature_100_to_300cm
- soil_moisture_0_to_1cm
- soil_moisture_1_to_3cm
- soil_moisture_3_to_9cm
- soil_moisture_9_to_27cm
- soil_moisture_27_to_81cm
- soil_moisture_81_to_243cm
- soil_moisture_243_to_729cm
- soil_moisture_729_to_2187cm
- soil_moisture_0_to_7cm
- soil_moisture_7_to_28cm
- soil_moisture_28_to_100cm
- soil_moisture_100_to_255cm
- soil_moisture_0_to_10cm
- soil_moisture_10_to_40cm
- soil_moisture_40_to_100cm
- soil_moisture_100_to_200cm
- soil_moisture_10_to_35cm
- soil_moisture_35_to_100cm
- soil_moisture_100_to_300cm
- uv_index
- uv_index_clear_sky
- is_day
- sunshine_duration
- wet_bulb_temperature_2m
- total_column_integrated_water_vapour
- cape
- lifted_index
- convective_inhibition
- freezing_level_height
- boundary_layer_height
- surface_temperature
- mass_density_8m
- snowfall_height
- convective_cloud_base
- convective_cloud_top
- updraft
- lightning_potential
- lightning_density
- snow_height
- roughness_length
- albedo
- k_index
- sea_level_height_msl
- sea_ice_thickness
- sea_surface_temperature
- ocean_current_velocity
- ocean_current_direction
- shortwave_radiation
- direct_radiation
- diffuse_radiation
- direct_normal_irradiance
- global_tilted_irradiance
- terrestrial_radiation
- shortwave_radiation_instant
- direct_radiation_instant
- diffuse_radiation_instant
- direct_normal_irradiance_instant
- global_tilted_irradiance_instant
- terrestrial_radiation_instant
- temperature_1000hPa
- temperature_950hPa
- temperature_925hPa
- temperature_900hPa
- temperature_850hPa
- temperature_800hPa
- temperature_750hPa
- temperature_700hPa
- temperature_650hPa
- temperature_600hPa
- temperature_550hPa
- temperature_500hPa
- temperature_450hPa
- temperature_400hPa
- temperature_350hPa
- temperature_300hPa
- temperature_275hPa
- temperature_250hPa
- temperature_225hPa
- temperature_200hPa
- temperature_175hPa
- temperature_150hPa
- temperature_125hPa
- temperature_100hPa
- temperature_50hPa
- temperature_10hPa
- dew_point_1000hPa
- dew_point_950hPa
- dew_point_925hPa
- dew_point_900hPa
- dew_point_850hPa
- dew_point_800hPa
- dew_point_750hPa
- dew_point_700hPa
- dew_point_650hPa
- dew_point_600hPa
- dew_point_550hPa
- dew_point_500hPa
- dew_point_450hPa
- dew_point_400hPa
- dew_point_350hPa
- dew_point_300hPa
- dew_point_275hPa
- dew_point_250hPa
- dew_point_225hPa
- dew_point_200hPa
- dew_point_175hPa
- dew_point_150hPa
- dew_point_125hPa
- dew_point_100hPa
- dew_point_50hPa
- dew_point_10hPa
- relative_humidity_1000hPa
- relative_humidity_950hPa
- relative_humidity_925hPa
- relative_humidity_900hPa
- relative_humidity_850hPa
- relative_humidity_800hPa
- relative_humidity_750hPa
- relative_humidity_700hPa
- relative_humidity_650hPa
- relative_humidity_600hPa
- relative_humidity_550hPa
- relative_humidity_500hPa
- relative_humidity_450hPa
- relative_humidity_400hPa
- relative_humidity_350hPa
- relative_humidity_300hPa
- relative_humidity_275hPa
- relative_humidity_250hPa
- relative_humidity_225hPa
- relative_humidity_200hPa
- relative_humidity_175hPa
- relative_humidity_150hPa
- relative_humidity_125hPa
- relative_humidity_100hPa
- relative_humidity_50hPa
- relative_humidity_10hPa
- cloud_cover_1000hPa
- cloud_cover_950hPa
- cloud_cover_925hPa
- cloud_cover_900hPa
- cloud_cover_850hPa
- cloud_cover_800hPa
- cloud_cover_750hPa
- cloud_cover_700hPa
- cloud_cover_650hPa
- cloud_cover_600hPa
- cloud_cover_550hPa
- cloud_cover_500hPa
- cloud_cover_450hPa
- cloud_cover_400hPa
- cloud_cover_350hPa
- cloud_cover_300hPa
- cloud_cover_275hPa
- cloud_cover_250hPa
- cloud_cover_225hPa
- cloud_cover_200hPa
- cloud_cover_175hPa
- cloud_cover_150hPa
- cloud_cover_125hPa
- cloud_cover_100hPa
- cloud_cover_50hPa
- cloud_cover_10hPa
- wind_speed_1000hPa
- wind_speed_950hPa
- wind_speed_925hPa
- wind_speed_900hPa
- wind_speed_850hPa
- wind_speed_800hPa
- wind_speed_750hPa
- wind_speed_700hPa
- wind_speed_650hPa
- wind_speed_600hPa
- wind_speed_550hPa
- wind_speed_500hPa
- wind_speed_450hPa
- wind_speed_400hPa
- wind_speed_350hPa
- wind_speed_300hPa
- wind_speed_275hPa
- wind_speed_250hPa
- wind_speed_225hPa
- wind_speed_200hPa
- wind_speed_175hPa
- wind_speed_150hPa
- wind_speed_125hPa
- wind_speed_100hPa
- wind_speed_50hPa
- wind_speed_10hPa
- wind_direction_1000hPa
- wind_direction_950hPa
- wind_direction_925hPa
- wind_direction_900hPa
- wind_direction_850hPa
- wind_direction_800hPa
- wind_direction_750hPa
- wind_direction_700hPa
- wind_direction_650hPa
- wind_direction_600hPa
- wind_direction_550hPa
- wind_direction_500hPa
- wind_direction_450hPa
- wind_direction_400hPa
- wind_direction_350hPa
- wind_direction_300hPa
- wind_direction_275hPa
- wind_direction_250hPa
- wind_direction_225hPa
- wind_direction_200hPa
- wind_direction_175hPa
- wind_direction_150hPa
- wind_direction_125hPa
- wind_direction_100hPa
- wind_direction_50hPa
- wind_direction_10hPa
- vertical_velocity_1000hPa
- vertical_velocity_950hPa
- vertical_velocity_925hPa
- vertical_velocity_900hPa
- vertical_velocity_850hPa
- vertical_velocity_800hPa
- vertical_velocity_750hPa
- vertical_velocity_700hPa
- vertical_velocity_650hPa
- vertical_velocity_600hPa
- vertical_velocity_550hPa
- vertical_velocity_500hPa
- vertical_velocity_450hPa
- vertical_velocity_400hPa
- vertical_velocity_350hPa
- vertical_velocity_300hPa
- vertical_velocity_275hPa
- vertical_velocity_250hPa
- vertical_velocity_225hPa
- vertical_velocity_200hPa
- vertical_velocity_175hPa
- vertical_velocity_150hPa
- vertical_velocity_125hPa
- vertical_velocity_100hPa
- vertical_velocity_50hPa
- vertical_velocity_10hPa
- geopotential_height_1000hPa
- geopotential_height_950hPa
- geopotential_height_925hPa
- geopotential_height_900hPa
- geopotential_height_850hPa
- geopotential_height_800hPa
- geopotential_height_750hPa
- geopotential_height_700hPa
- geopotential_height_650hPa
- geopotential_height_600hPa
- geopotential_height_550hPa
- geopotential_height_500hPa
- geopotential_height_450hPa
- geopotential_height_400hPa
- geopotential_height_350hPa
- geopotential_height_300hPa
- geopotential_height_275hPa
- geopotential_height_250hPa
- geopotential_height_225hPa
- geopotential_height_200hPa
- geopotential_height_175hPa
- geopotential_height_150hPa
- geopotential_height_125hPa
- geopotential_height_100hPa
- geopotential_height_50hPa
- geopotential_height_10hPa
- name: daily
in: query
description: >-
A list of daily weather variable aggregations.
explode: false
schema:
type: array
items:
type: string
enum:
- weather_code
- temperature_2m_max
- temperature_2m_min
- apparent_temperature_max
- apparent_temperature_min
- sunrise
- sunset
- daylight_duration
- sunshine_duration
- uv_index_max
- uv_index_clear_sky_max
- rain_sum
- showers_sum
- snowfall_sum
- precipitation_sum
- precipitation_hours
- precipitation_probability_max
- wind_speed_10m_max
- wind_gusts_10m_max
- wind_direction_10m_dominant
- shortwave_radiation_sum
- et0_fao_evapotranspiration
- name: current
in: query
description: >-
A list of variables to return for the current conditions.
explode: false
schema:
type: array
items:
type: string
enum:
- temperature_2m
- relative_humidity_2m
- apparent_temperature
- is_day
- precipitation
- rain
- showers
- snowfall
- weather_code
- cloud_cover
- pressure_msl
- surface_pressure
- wind_speed_10m
- wind_direction_10m
- wind_gusts_10m
- name: minutely_15
in: query
description: >-
A list of weather variables at 15-minute intervals.
explode: false
schema:
type: array
items:
type: string
enum:
- temperature_2m
- relative_humidity_2m
- dew_point_2m
- apparent_temperature
- precipitation
- rain
- snowfall
- snowfall_height
- freezing_level_height
- sunshine_duration
- weather_code
- wind_speed_10m
- wind_speed_20m
- wind_speed_50m
- wind_speed_80m
- wind_speed_100m
- wind_direction_10m
- wind_direction_20m
- wind_direction_50m
- wind_direction_80m
- wind_direction_100m
- wind_gusts_10m
- visibility
- cape
- lightning_potential
- is_day
- name: elevation
in: query
schema:
type: number
format: float
- name: temperature_unit
in: query
schema:
type: string
default: celsius
enum: [celsius, fahrenheit]
- name: wind_speed_unit
in: query
schema:
type: string
default: kmh
enum: [kmh, ms, mph, kn]
- name: precipitation_unit
in: query
schema:
type: string
default: mm
enum: [mm, inch]
- name: timeformat
in: query
description: >-
If format unixtime is selected, all time values are returned in UNIX epoch time.
schema:
type: string
default: iso8601
enum: [iso8601, unixtime]
- name: timezone
in: query
description: >-
Any IANA time zone name is supported. Use auto to resolve the local time zone.
schema:
type: string
- name: past_days
in: query
description: >-
Return past days of data.
schema:
type: integer
default: 0
minimum: 0
maximum: 92
- name: forecast_days
in: query
description: >-
Number of forecast days.
schema:
type: integer
default: 7
minimum: 0
maximum: 16
- name: past_hours
in: query
schema:
type: integer
- name: forecast_hours
in: query
schema:
type: integer
- name: start_date
in: query
description: >-
Start date of the time interval in ISO 8601 format.
schema:
type: string
format: date
- name: end_date
in: query
description: >-
End date of the time interval in ISO 8601 format.
schema:
type: string
format: date
- name: tilt
in: query
description: >-
Slope tilt in degrees for global_tilted_irradiance calculation.
schema:
type: number
format: float
default: 0
- name: azimuth
in: query
description: >-
Azimuth for global_tilted_irradiance. North=0, East=90, South=180, West=270.
schema:
type: number
format: float
default: 0
- name: cell_selection
in: query
description: >-
Grid cell selection preference: land, sea, or nearest.
schema:
type: string
enum: [land, sea, nearest]
- name: apikey
in: query
description: >-
Only required for commercial subscriptions.
schema:
type: string
- name: models
in: query
description: Manually select one or more weather models.
explode: false
schema:
type: array
items:
type: string
enum:
- best_match
- ecmwf_ifs
- ecmwf_ifs025
- ecmwf_aifs025_single
- cma_grapes_global
- bom_access_global
- gfs_seamless
- gfs_global
- gfs_hrrr
- ncep_nbm_conus
- ncep_nam_conus
- gfs_graphcast025
- ncep_aigfs025
- ncep_hgefs025_ensemble_mean
- jma_seamless
- jma_msm
- jma_gsm
- kma_seamless
- kma_ldps
- kma_gdps
- icon_seamless
- icon_global
- icon_eu
- icon_d2
- gem_seamless
- gem_global
- gem_regional
- gem_hrdps_continental
- gem_hrdps_west
- meteofrance_seamless
- meteofrance_arpege_world
- meteofrance_arpege_europe
- meteofrance_arome_france
- meteofrance_arome_france_hd
- italia_meteo_arpae_icon_2i
- metno_seamless
- metno_nordic
- knmi_seamless
- knmi_harmonie_arome_europe
- knmi_harmonie_arome_netherlands
- dmi_seamless
- dmi_harmonie_arome_europe
- ukmo_seamless
- ukmo_global_deterministic_10km
- ukmo_uk_deterministic_2km
- meteoswiss_icon_seamless
- meteoswiss_icon_ch1
- meteoswiss_icon_ch2
- geosphere_seamless
- geosphere_arome_austria
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
latitude:
type: number
format: float
longitude:
type: number
format: float
elevation:
type: number
format: float
generationtime_ms:
type: number
format: float
utc_offset_seconds:
type: integer
timezone:
type: string
timezone_abbreviation:
type: string
hourly:
type: object
properties:
time:
type: array
items:
type: string
temperature_2m:
type: array
items:
type: number
format: float
temperature_2m_min:
type: array
items:
type: number
format: float
temperature_2m_max:
type: array
items:
type: number
format: float
relative_humidity_2m:
type: array
items:
type: number
format: float
dew_point_2m:
type: array
items:
type: number
format: float
apparent_temperature:
type: array
items:
type: number
format: float
precipitation_probability:
type: array
items:
type: number
format: float
precipitation:
type: array
items:
type: number
format: float
rain:
type: array
items:
type: number
format: float
showers:
type: array
items:
type: number
format: float
snowfall:
type: array
items:
type: number
format: float
snow_depth:
type: array
items:
type: number
format: float
snowfall_water_equivalent:
type: array
items:
type: number
format: float
snow_depth_water_equivalent:
type: array
items:
type: number
format: float
weather_code:
type: array
items:
type: integer
pressure_msl:
type: array
items:
type: number
format: float
surface_pressure:
type: array
items:
type: number
format: float
cloud_cover:
type: array
items:
type: number
format: float
cloud_cover_low:
type: array
items:
type: number
format: float
cloud_cover_mid:
type: array
items:
type: number
format: float
cloud_cover_high:
type: array
items:
type: number
format: float
visibility:
type: array
items:
type: number
format: float
evapotranspiration:
type: array
items:
type: number
format: float
et0_fao_evapotranspiration:
type: array
items:
type: number
format: float
vapour_pressure_deficit:
type: array
items:
type: number
format: float
runoff:
type: array
items:
type: number
format: float
precipitation_type:
type: array
items:
type: integer
rain_probability:
type: array
items:
type: number
format: float
snowfall_probability:
type: array
items:
type: number
format: float
freezing_rain_probability:
type: array
items:
type: number
format: float
ice_pellets_probability:
type: array
items:
type: number
format: float
thunderstorm_probability:
type: array
items:
type: number
format: float
wind_speed_10m:
type: array
items:
type: number
format: float
wind_speed_20m:
type: array
items:
type: number
format: float
wind_speed_30m:
type: array
items:
type: number
format: float
wind_speed_40m:
type: array
items:
type: number
format: float
wind_speed_50m:
type: array
items:
type: number
format: float
wind_speed_70m:
type: array
items:
type: number
format: float
wind_speed_80m:
type: array
items:
type: number
format: float
wind_speed_100m:
type: array
items:
type: number
format: float
wind_speed_120m:
type: array
items:
type: number
format: float
wind_speed_140m:
type: array
items:
type: number
format: float
wind_speed_150m:
type: array
items:
type: number
format: float
wind_speed_160m:
type: array
items:
type: number
format: float
wind_speed_180m:
type: array
items:
type: number
format: float
wind_speed_200m:
type: array
items:
type: number
format: float
wind_direction_10m:
type: array
# --- truncated at 32 KB (133 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/open-meteo/refs/heads/main/openapi/open-meteo-forecast-openapi.yml