Gridded Forecast

This endpoint allows getting the gridded output of global forecasts for a single variable. These outputs are returned as a netCDF (.nc) file.

The variable and level parameters are used to specify the variable and level to retrieve.

A model parameter must be provided to specify which weather model’s forecast to retrieve. You can find a list of available models here.

forecasts/v1/<model>/griddedforecasts/v1/<model>/gridded

windborne griddedwindborne gridded

from windborne import get_gridded_forecastfrom windborne import get_gridded_forecast

Archived forecasts

Individual variables are only available for active forecasts. For archived forecasts, only the complete dataset with all variables is available. Set the variable parameter to all .

Available Levels

For upper-level atmospheric variables, set the pressure level in hectopascals (hPa) using the level query parameter alongside the variable . To get the same list as JSON via the API, see the Variables endpoint

Available levels (hPa)
10 30 50 70 100 150 200 250 300 350 400 450 500 550 600 650 700 750 800 850 900 925 950 975 1000

Available levels (hPa)
Only surface level variables are available.

Available levels (hPa)
10 30 50 70 100 150 200 250 300 350 400 450 500 550 600 650 700 750 800 850 900 925 950 975 1000

Available levels (hPa)
Only surface level variables are available.

Available levels (hPa)
10 30 50 70 100 150 200 250 300 350 400 450 500 550 600 650 700 750 800 850 900 925 950 975 1000

Available levels (hPa)
Only surface level variables are available.

Available levels (hPa)
Only surface level variables are available.

Available levels (hPa)
Only surface level variables are available.

Available levels (hPa)
Only surface level variables are available.

Available levels (hPa)
Only surface level variables are available.

Available Variables

All variables for each model are listed below. To get the same list as JSON via the API, see the Variables endpoint .

Name	Type	Description	Unit
all	all	All variables at all heights. Only variable available for archived initialization_times.	-
temperature_2m	surface	2m temperature	K
wind_u_10m	surface	10m u-component of wind	m/s
wind_v_10m	surface	10m v-component of wind	m/s
wind_u_100m	surface	100m u-component of wind	m/s
wind_v_100m	surface	100m v-component of wind	m/s
pressure_msl	surface	Mean sea level pressure	hPa
geopotential	upper-level	Geopotential Not geopotential height	m²/s²
temperature	upper-level	Temperature	K
wind_u	upper-level	U-component of wind	m/s
wind_v	upper-level	V-component of wind	m/s

Name	Type	Description	Unit
all	all	All variables at all heights. Only variable available for archived initialization_times.	-
temperature_2m	surface	2m temperature	K
dewpoint_2m	surface	2m dewpoint temperature	K
wind_u_10m	surface	10m u-component of wind	m/s
wind_v_10m	surface	10m v-component of wind	m/s
wind_speed_10m	surface	10m wind speed computed as mean of wind speed over ens_members.	m/s
wind_u_100m	surface	100m u-component of wind	m/s
wind_v_100m	surface	100m v-component of wind	m/s
wind_speed_100m	surface	100m wind speed computed as mean of wind speed over ens_members.	m/s
pressure_msl	surface	Mean sea level pressure	hPa
total_precipitation_1h	surface	Total precipitation over the last hour	mm
total_precipitation_6h	surface	Total precipitation over the last 6 hours	mm

Name	Type	Description	Unit
all	all	All variables at all heights. Only variable available for archived initialization_times.	-
temperature_2m	surface	2m temperature	K
wind_u_10m	surface	10m u-component of wind	m/s
wind_v_10m	surface	10m v-component of wind	m/s
wind_u_100m	surface	100m u-component of wind	m/s
wind_v_100m	surface	100m v-component of wind	m/s
pressure_msl	surface	Mean sea level pressure	hPa
short_wave_radiation	surface	Mean surface net short wave radiation flux	W/m²
total_cloud_cover	surface	Total cloud cover	%
dewpoint_2m	surface	2m dewpoint temperature	K
total_precipitation_1h	surface	Total precipitation over the last hour	mm
total_precipitation_6h	surface	Total precipitation over the last 6 hours	mm
geopotential	upper-level	Geopotential Not geopotential height	m²/s²
temperature	upper-level	Temperature	K
wind_u	upper-level	U-component of wind	m/s
wind_v	upper-level	V-component of wind	m/s
specific_humidity	surface	The mass of water vapor per unit mass of dry air	kg/kg

Name	Type	Description	Unit
all	all	All variables at all heights. Only variable available for archived initialization_times.	-
temperature_2m	surface	2m temperature	K
wind_u_10m	surface	10m u-component of wind	m/s
wind_v_10m	surface	10m v-component of wind	m/s
wind_speed_10m	surface	10m wind speed computed as mean of wind speed over ens_members.	m/s
wind_u_100m	surface	100m u-component of wind	m/s
wind_v_100m	surface	100m v-component of wind	m/s
wind_speed_100m	surface	100m wind speed computed as mean of wind speed over ens_members.	m/s
pressure_msl	surface	Mean sea level pressure	hPa
dewpoint_2m	surface	2m dewpoint temperature	K
total_precipitation_1h	surface	Total precipitation over the last hour	mm
total_precipitation_6h	surface	Total precipitation over the last 6 hours	mm

Name	Type	Description	Unit
all	all	All variables at all heights. Only variable available for archived initialization_times.	-
temperature_2m	surface	2m temperature	K
wind_u_10m	surface	10m u-component of wind	m/s
wind_v_10m	surface	10m v-component of wind	m/s
wind_u_100m	surface	100m u-component of wind	m/s
wind_v_100m	surface	100m v-component of wind	m/s
pressure_msl	surface	Mean sea level pressure	hPa
short_wave_radiation	surface	Mean surface net short wave radiation flux	W/m²
total_cloud_cover	surface	Total cloud cover	%
dewpoint_2m	surface	2m dewpoint temperature	K
total_precipitation_1h	surface	Total precipitation over the last hour	mm
total_precipitation_6h	surface	Total precipitation over the last 6 hours	mm
maximum_temperature_2m	surface	maximum 2m temperature	K
minimum_temperature_2m	surface	minimum 2m temperature	K
geopotential	upper-level	Geopotential Not geopotential height	m²/s²
temperature	upper-level	Temperature	K
wind_u	upper-level	U-component of wind	m/s
wind_v	upper-level	V-component of wind	m/s
specific_humidity	surface	The mass of water vapor per unit mass of dry air	kg/kg

Name	Type	Description	Unit
all	all	All variables at all heights. Only variable available for archived initialization_times.	-
temperature_2m	surface	2m temperature	K
dewpoint_2m	surface	2m dewpoint temperature	K
pressure_msl	surface	Mean sea level pressure	hPa
total_precipitation_1h	surface	Total precipitation over the last hour	mm
wind_u_10m	surface	10m u-component of wind	m/s
wind_v_10m	surface	10m v-component of wind	m/s
wind_u_100m	surface	100m u-component of wind	m/s
wind_v_100m	surface	100m v-component of wind	m/s

Name	Type	Description	Unit
all	all	All variables at all heights. Only variable available for archived initialization_times.	-
temperature_2m	surface	2m temperature	K

Name	Type	Description	Unit
all	all	All variables at all heights. Only variable available for archived initialization_times.	-
temperature_2m	surface	2m temperature	K
dewpoint_2m	surface	2m dewpoint temperature	K
pressure_msl	surface	Mean sea level pressure	hPa
total_precipitation_1h	surface	Total precipitation over the last hour	mm
wind_u_10m	surface	10m u-component of wind	m/s
wind_v_10m	surface	10m v-component of wind	m/s
wind_u_100m	surface	100m u-component of wind	m/s
wind_v_100m	surface	100m v-component of wind	m/s

Name	Type	Description	Unit
all	all	All variables at all heights. Only variable available for archived initialization_times.	-
temperature_2m	surface	2m temperature	K
dewpoint_2m	surface	2m dewpoint temperature	K
pressure_msl	surface	Mean sea level pressure	hPa
total_precipitation_1h	surface	Total precipitation over the last hour	mm
wind_u_10m	surface	10m u-component of wind	m/s
wind_v_10m	surface	10m v-component of wind	m/s
wind_u_100m	surface	100m u-component of wind	m/s
wind_v_100m	surface	100m v-component of wind	m/s

Name	Type	Description	Unit
all	all	All variables at all heights. Only variable available for archived initialization_times.	-
temperature_2m	surface	2m temperature	K
dewpoint_2m	surface	2m dewpoint temperature	K
pressure_msl	surface	Mean sea level pressure	hPa
total_precipitation_1h	surface	Total precipitation over the last hour	mm
wind_u_10m	surface	10m u-component of wind	m/s
wind_v_10m	surface	10m v-component of wind	m/s

Query parameters

Name	Description	Format
variable Required	Variable to download. Use a surface variable (e.g., temperature_2m) or combine with level for upper-level variables (e.g., temperature at 500 hPa).	string
level Optional	Pressure level in hectopascals for upper-level variables.	number
time Required	The time at which the forecast is valid. Alternatively, you can specify initialization_time and forecast_hour. This looks solely at the date and the hour; minutes and seconds are discarded. If there is no forecast available within an hour of the requested time, it will return a 404.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
initialization_time Alternative	The initialization time for the forecast. Must be used with forecast_hour. Cannot be used with time. Uses only date and hour; minutes and seconds are discarded.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
forecast_hour Alternative	Hours from the initialization_time for which to get the forecast. Must be used with initialization_time. Cannot be used with time. If initialization_time is 2023-01-01T00:00:00 and forecast_hour is 6, the forecast will be for 2023-01-01T06:00:00.	integer
ens_member Optional	The ensemble member to get forecasts for.	mean or 0-23

Name	Description	Format
variable Required	Variable to download. Use a surface variable (e.g., temperature_2m) or combine with level for upper-level variables (e.g., temperature at 500 hPa).	string
level Optional	Pressure level in hectopascals for upper-level variables.	number
time Required	The time at which the forecast is valid. Alternatively, you can specify initialization_time and forecast_hour. This looks solely at the date and the hour; minutes and seconds are discarded. If there is no forecast available within an hour of the requested time, it will return a 404.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
initialization_time Alternative	The initialization time for the forecast. Must be used with forecast_hour. Cannot be used with time. Uses only date and hour; minutes and seconds are discarded.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
forecast_hour Alternative	Hours from the initialization_time for which to get the forecast. Must be used with initialization_time. Cannot be used with time. If initialization_time is 2023-01-01T00:00:00 and forecast_hour is 6, the forecast will be for 2023-01-01T06:00:00.	integer
ens_member Optional	The ensemble member to get initialization times for.	mean or 0-23

Name	Description	Format
variable Required	Variable to download. Use a surface variable (e.g., temperature_2m) or combine with level for upper-level variables (e.g., temperature at 500 hPa).	string
level Optional	Pressure level in hectopascals for upper-level variables.	number
time Required	The time at which the forecast is valid. Alternatively, you can specify initialization_time and forecast_hour. This looks solely at the date and the hour; minutes and seconds are discarded. If there is no forecast available within an hour of the requested time, it will return a 404.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
initialization_time Alternative	The initialization time for the forecast. Must be used with forecast_hour. Cannot be used with time. Uses only date and hour; minutes and seconds are discarded.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
forecast_hour Alternative	Hours from the initialization_time for which to get the forecast. Must be used with initialization_time. Cannot be used with time. If initialization_time is 2023-01-01T00:00:00 and forecast_hour is 6, the forecast will be for 2023-01-01T06:00:00.	integer

Name	Description	Format
variable Required	Variable to download. Use a surface variable (e.g., temperature_2m) or combine with level for upper-level variables (e.g., temperature at 500 hPa).	string
level Optional	Pressure level in hectopascals for upper-level variables.	number
time Required	The time at which the forecast is valid. Alternatively, you can specify initialization_time and forecast_hour. This looks solely at the date and the hour; minutes and seconds are discarded. If there is no forecast available within an hour of the requested time, it will return a 404.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
initialization_time Alternative	The initialization time for the forecast. Must be used with forecast_hour. Cannot be used with time. Uses only date and hour; minutes and seconds are discarded.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
forecast_hour Alternative	Hours from the initialization_time for which to get the forecast. Must be used with initialization_time. Cannot be used with time. If initialization_time is 2023-01-01T00:00:00 and forecast_hour is 6, the forecast will be for 2023-01-01T06:00:00.	integer
ens_member Optional	The ensemble member to get forecasts for.	mean or 0-23

Name	Description	Format
variable Required	Variable to download. Use a surface variable (e.g., temperature_2m) or combine with level for upper-level variables (e.g., temperature at 500 hPa).	string
level Optional	Pressure level in hectopascals for upper-level variables.	number
time Required	The time at which the forecast is valid. Alternatively, you can specify initialization_time and forecast_hour. This looks solely at the date and the hour; minutes and seconds are discarded. If there is no forecast available within an hour of the requested time, it will return a 404.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
initialization_time Alternative	The initialization time for the forecast. Must be used with forecast_hour. Cannot be used with time. Uses only date and hour; minutes and seconds are discarded.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
forecast_hour Alternative	Hours from the initialization_time for which to get the forecast. Must be used with initialization_time. Cannot be used with time. If initialization_time is 2023-01-01T00:00:00 and forecast_hour is 6, the forecast will be for 2023-01-01T06:00:00.	integer
ens_member Optional	The ensemble member to get forecasts for.	mean or 0-23

Name	Description	Format
variable Required	Variable to download. Use a surface variable (e.g., temperature_2m) or combine with level for upper-level variables (e.g., temperature at 500 hPa).	string
level Optional	Pressure level in hectopascals for upper-level variables.	number
time Required	The time at which the forecast is valid. Alternatively, you can specify initialization_time and forecast_hour. This looks solely at the date and the hour; minutes and seconds are discarded. If there is no forecast available within an hour of the requested time, it will return a 404.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
initialization_time Alternative	The initialization time for the forecast. Must be used with forecast_hour. Cannot be used with time. Uses only date and hour; minutes and seconds are discarded.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
forecast_hour Alternative	Hours from the initialization_time for which to get the forecast. Must be used with initialization_time. Cannot be used with time. If initialization_time is 2023-01-01T00:00:00 and forecast_hour is 6, the forecast will be for 2023-01-01T06:00:00.	integer

Name	Description	Format
variable Required	Variable to download. Use a surface variable (e.g., temperature_2m) or combine with level for upper-level variables (e.g., temperature at 500 hPa).	string
level Optional	Pressure level in hectopascals for upper-level variables.	number
time Required	The time at which the forecast is valid. Alternatively, you can specify initialization_time and forecast_hour. This looks solely at the date and the hour; minutes and seconds are discarded. If there is no forecast available within an hour of the requested time, it will return a 404.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
initialization_time Alternative	The initialization time for the forecast. Must be used with forecast_hour. Cannot be used with time. Uses only date and hour; minutes and seconds are discarded.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
forecast_hour Alternative	Hours from the initialization_time for which to get the forecast. Must be used with initialization_time. Cannot be used with time. If initialization_time is 2023-01-01T00:00:00 and forecast_hour is 6, the forecast will be for 2023-01-01T06:00:00.	integer

Name	Description	Format
variable Required	Variable to download. Use a surface variable (e.g., temperature_2m) or combine with level for upper-level variables (e.g., temperature at 500 hPa).	string
level Optional	Pressure level in hectopascals for upper-level variables.	number
time Required	The time at which the forecast is valid. Alternatively, you can specify initialization_time and forecast_hour. This looks solely at the date and the hour; minutes and seconds are discarded. If there is no forecast available within an hour of the requested time, it will return a 404.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
initialization_time Alternative	The initialization time for the forecast. Must be used with forecast_hour. Cannot be used with time. Uses only date and hour; minutes and seconds are discarded.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
forecast_hour Alternative	Hours from the initialization_time for which to get the forecast. Must be used with initialization_time. Cannot be used with time. If initialization_time is 2023-01-01T00:00:00 and forecast_hour is 6, the forecast will be for 2023-01-01T06:00:00.	integer

Name	Description	Format
variable Required	Variable to download. Use a surface variable (e.g., temperature_2m) or combine with level for upper-level variables (e.g., temperature at 500 hPa).	string
level Optional	Pressure level in hectopascals for upper-level variables.	number
time Required	The time at which the forecast is valid. Alternatively, you can specify initialization_time and forecast_hour. This looks solely at the date and the hour; minutes and seconds are discarded. If there is no forecast available within an hour of the requested time, it will return a 404.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
initialization_time Alternative	The initialization time for the forecast. Must be used with forecast_hour. Cannot be used with time. Uses only date and hour; minutes and seconds are discarded.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
forecast_hour Alternative	Hours from the initialization_time for which to get the forecast. Must be used with initialization_time. Cannot be used with time. If initialization_time is 2023-01-01T00:00:00 and forecast_hour is 6, the forecast will be for 2023-01-01T06:00:00.	integer

Name	Description	Format
variable Required	Variable to download. Use a surface variable (e.g., temperature_2m) or combine with level for upper-level variables (e.g., temperature at 500 hPa).	string
level Optional	Pressure level in hectopascals for upper-level variables.	number
time Required	The time at which the forecast is valid. Alternatively, you can specify initialization_time and forecast_hour. This looks solely at the date and the hour; minutes and seconds are discarded. If there is no forecast available within an hour of the requested time, it will return a 404.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
initialization_time Alternative	The initialization time for the forecast. Must be used with forecast_hour. Cannot be used with time. Uses only date and hour; minutes and seconds are discarded.	ISO 8601, YYYYMMDDHH, or YYYY-MM-DDTHH
forecast_hour Alternative	Hours from the initialization_time for which to get the forecast. Must be used with initialization_time. Cannot be used with time. If initialization_time is 2023-01-01T00:00:00 and forecast_hour is 6, the forecast will be for 2023-01-01T06:00:00.	integer

Name	Description
-m, --model	Set to wm5c .
variable Required	Variable to download. Can be FULL, a surface variable (e.g., temperature_2m), or an upper-level variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
time Required	Target valid time for the forecast (YYYYMMDDHH, YYYY-MM-DDTHH, or full ISO8601). Minutes/seconds are typically ignored by the backend when finding the closest cycle.
output_file Required	Path to save the NetCDF (.nc) file.
-e --ens-member Optional	The ensemble member to get initialization times for. Can be "mean" or a number between 0 and 23.

Name	Description
-m, --model	Set to wm4.5-ens .
variable Required	Variable to download. Can be FULL, a surface variable (e.g., temperature_2m), or an upper-level variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
time Required	Target valid time for the forecast (YYYYMMDDHH, YYYY-MM-DDTHH, or full ISO8601). Minutes/seconds are typically ignored by the backend when finding the closest cycle.
output_file Required	Path to save the NetCDF (.nc) file.
-e --ens-member Optional	The ensemble member to get initialization times for. Can be "mean" or a number between 0 and 23.

Name	Description
-m, --model	Set to wm4 .
variable Required	Variable to download. Can be FULL, a surface variable (e.g., temperature_2m), or an upper-level variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
time Required	Target valid time for the forecast (YYYYMMDDHH, YYYY-MM-DDTHH, or full ISO8601). Minutes/seconds are typically ignored by the backend when finding the closest cycle.
output_file Required	Path to save the NetCDF (.nc) file.

Name	Description
-m, --model	Set to wm4-ens .
variable Required	Variable to download. Can be FULL, a surface variable (e.g., temperature_2m), or an upper-level variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
time Required	Target valid time for the forecast (YYYYMMDDHH, YYYY-MM-DDTHH, or full ISO8601). Minutes/seconds are typically ignored by the backend when finding the closest cycle.
output_file Required	Path to save the NetCDF (.nc) file.
-e --ens-member Optional	The ensemble member to get initialization times for. Can be "mean" or a number between 0 and 23.

Name	Description
-m, --model	Set to wm4-intra .
variable Required	Variable to download. Can be FULL, a surface variable (e.g., temperature_2m), or an upper-level variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
time Required	Target valid time for the forecast (YYYYMMDDHH, YYYY-MM-DDTHH, or full ISO8601). Minutes/seconds are typically ignored by the backend when finding the closest cycle.
output_file Required	Path to save the NetCDF (.nc) file.

Name	Description
-m, --model	Set to ecmwf-det .
variable Required	Variable to download. Can be FULL, a surface variable (e.g., temperature_2m), or an upper-level variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
time Required	Target valid time for the forecast (YYYYMMDDHH, YYYY-MM-DDTHH, or full ISO8601). Minutes/seconds are typically ignored by the backend when finding the closest cycle.
output_file Required	Path to save the NetCDF (.nc) file.

Name	Description
-m, --model	Set to ecmwf-ens .
variable Required	Variable to download. Can be FULL, a surface variable (e.g., temperature_2m), or an upper-level variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
time Required	Target valid time for the forecast (YYYYMMDDHH, YYYY-MM-DDTHH, or full ISO8601). Minutes/seconds are typically ignored by the backend when finding the closest cycle.
output_file Required	Path to save the NetCDF (.nc) file.

Name	Description
-m, --model	Set to aifs .
variable Required	Variable to download. Can be FULL, a surface variable (e.g., temperature_2m), or an upper-level variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
time Required	Target valid time for the forecast (YYYYMMDDHH, YYYY-MM-DDTHH, or full ISO8601). Minutes/seconds are typically ignored by the backend when finding the closest cycle.
output_file Required	Path to save the NetCDF (.nc) file.

Name	Description
-m, --model	Set to gfs .
variable Required	Variable to download. Can be FULL, a surface variable (e.g., temperature_2m), or an upper-level variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
time Required	Target valid time for the forecast (YYYYMMDDHH, YYYY-MM-DDTHH, or full ISO8601). Minutes/seconds are typically ignored by the backend when finding the closest cycle.
output_file Required	Path to save the NetCDF (.nc) file.

Name	Description
-m, --model	Set to hrrr .
variable Required	Variable to download. Can be FULL, a surface variable (e.g., temperature_2m), or an upper-level variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
time Required	Target valid time for the forecast (YYYYMMDDHH, YYYY-MM-DDTHH, or full ISO8601). Minutes/seconds are typically ignored by the backend when finding the closest cycle.
output_file Required	Path to save the NetCDF (.nc) file.

Name	Description
variable Required	Specifies the forecast variable(s) to download. Options: FULL (all variables), surface variable (e.g., temperature_2m), or level/variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
model Required	Set to wm5c .
time Required	An ISO 8601 date string representing the forecast time. Formats: YYYYMMDDHH, YYYY-MM-DDTHH, YYYY-MM-DDTHH:mm:ss. Uses only date and hour; minutes and seconds are discarded.
output_file Required	Path to save the file.
ensemble_member Optional	The ensemble member to get initialization times for. Can be "mean" or a number between 0 and 23.

Name	Description
variable Required	Specifies the forecast variable(s) to download. Options: FULL (all variables), surface variable (e.g., temperature_2m), or level/variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
model Required	Set to wm4.5-ens .
time Required	An ISO 8601 date string representing the forecast time. Formats: YYYYMMDDHH, YYYY-MM-DDTHH, YYYY-MM-DDTHH:mm:ss. Uses only date and hour; minutes and seconds are discarded.
output_file Required	Path to save the file.
ensemble_member Optional	The ensemble member to get initialization times for. Can be "mean" or a number between 0 and 23.

Name	Description
variable Required	Specifies the forecast variable(s) to download. Options: FULL (all variables), surface variable (e.g., temperature_2m), or level/variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
model Required	Set to wm4 .
time Required	An ISO 8601 date string representing the forecast time. Formats: YYYYMMDDHH, YYYY-MM-DDTHH, YYYY-MM-DDTHH:mm:ss. Uses only date and hour; minutes and seconds are discarded.
output_file Required	Path to save the file.

Name	Description
variable Required	Specifies the forecast variable(s) to download. Options: FULL (all variables), surface variable (e.g., temperature_2m), or level/variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
model Required	Set to wm4-ens .
time Required	An ISO 8601 date string representing the forecast time. Formats: YYYYMMDDHH, YYYY-MM-DDTHH, YYYY-MM-DDTHH:mm:ss. Uses only date and hour; minutes and seconds are discarded.
output_file Required	Path to save the file.
ensemble_member Optional	The ensemble member to get initialization times for. Can be "mean" or a number between 0 and 23.

Name	Description
variable Required	Specifies the forecast variable(s) to download. Options: FULL (all variables), surface variable (e.g., temperature_2m), or level/variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
model Required	Set to wm4-intra .
time Required	An ISO 8601 date string representing the forecast time. Formats: YYYYMMDDHH, YYYY-MM-DDTHH, YYYY-MM-DDTHH:mm:ss. Uses only date and hour; minutes and seconds are discarded.
output_file Required	Path to save the file.

Name	Description
variable Required	Specifies the forecast variable(s) to download. Options: FULL (all variables), surface variable (e.g., temperature_2m), or level/variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
model Required	Set to ecmwf-det .
time Required	An ISO 8601 date string representing the forecast time. Formats: YYYYMMDDHH, YYYY-MM-DDTHH, YYYY-MM-DDTHH:mm:ss. Uses only date and hour; minutes and seconds are discarded.
output_file Required	Path to save the file.

Name	Description
variable Required	Specifies the forecast variable(s) to download. Options: FULL (all variables), surface variable (e.g., temperature_2m), or level/variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
model Required	Set to ecmwf-ens .
time Required	An ISO 8601 date string representing the forecast time. Formats: YYYYMMDDHH, YYYY-MM-DDTHH, YYYY-MM-DDTHH:mm:ss. Uses only date and hour; minutes and seconds are discarded.
output_file Required	Path to save the file.

Name	Description
variable Required	Specifies the forecast variable(s) to download. Options: FULL (all variables), surface variable (e.g., temperature_2m), or level/variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
model Required	Set to aifs .
time Required	An ISO 8601 date string representing the forecast time. Formats: YYYYMMDDHH, YYYY-MM-DDTHH, YYYY-MM-DDTHH:mm:ss. Uses only date and hour; minutes and seconds are discarded.
output_file Required	Path to save the file.

Name	Description
variable Required	Specifies the forecast variable(s) to download. Options: FULL (all variables), surface variable (e.g., temperature_2m), or level/variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
model Required	Set to gfs .
time Required	An ISO 8601 date string representing the forecast time. Formats: YYYYMMDDHH, YYYY-MM-DDTHH, YYYY-MM-DDTHH:mm:ss. Uses only date and hour; minutes and seconds are discarded.
output_file Required	Path to save the file.

Name	Description
variable Required	Specifies the forecast variable(s) to download. Options: FULL (all variables), surface variable (e.g., temperature_2m), or level/variable (e.g., 500/temperature).
level Optional	Pressure level in hectopascals for upper-level variables (e.g., 500).
model Required	Set to hrrr .
time Required	An ISO 8601 date string representing the forecast time. Formats: YYYYMMDDHH, YYYY-MM-DDTHH, YYYY-MM-DDTHH:mm:ss. Uses only date and hour; minutes and seconds are discarded.
output_file Required	Path to save the file.

Response parameters

Returns a netCDF (.nc) file containing gridded forecast data for the specified variable. This will generally be a redirect to a presigned URL on R2, so you will need to follow the redirect to get the file. Use the -L flag in curl. Only in the short time it takes for the file to be uploaded will it be served directly.

GET Gridded Forecast

Archived forecasts

Available Levels

Available Variables

Query parameters

Response parameters