Retrieve interpolated forecasts for arbitrary geographic coordinates. This endpoint provides estimated weather forecasts at individual locations by interpolating values from the underlying gridded model output.
Unlike the dynamic point forecast endpoint, which uses WindBorne’s custom modeling for higher accuracy, this endpoint generates values through spatial interpolation of the grid.
Request a native or derived variable by name. If variable is omitted, the endpoint returns its default variable set; derived variables are not included automatically.
Use the model-specific URL below to choose which weather model's forecast to retrieve. You can find a list of available models here.
| Name | Type | Description |
|---|---|---|
| coordinates Required | string (lat,lon;...) | Latitude,longitude pairs separated by semicolons, for example 37,-121;40.3,-100. Results preserve the input order. On wm-6-3km, coordinates must fall within the model's bounding box. Range: latitude −90° to 90°, longitude −180° to 180° |
| variable Optional | string | Comma-separated model variable(s) to interpolate instead of the default variable set. On WM-6, request a native variable (e.g., temperature_2m) or a derived variable (e.g., thermal_strength) by name; for upper-level variables, also specify level. Derived variables are not included in the default set and are available only for non-archived forecasts. Use the Variables endpoint to list what's available. |
| level Optional | integer | Pressure level for an upper-level variable, in hPa. See Variables for the levels available for the selected model. Models: wm-6; Unit: hPa |
| include_distribution Optional | boolean | If true, adds distribution outputs such as percentiles, standard deviation, thresholds, and precipitation-type probabilities. Requires variable to be set to a single variable. Models: wm-6; Default: false |
| min_forecast_time Optional | string (ISO 8601) | Earliest valid time to include in the response. |
| max_forecast_time Optional | string (ISO 8601) | Latest valid time to include in the response. |
| min_forecast_hour Optional | integer | Earliest forecast hour to include in the response, counted from forecast zero. Unit: hours |
| max_forecast_hour Optional | integer | Latest forecast hour to include in the response, counted from forecast zero. Unit: hours |
| initialization_time Optional | string (ISO 8601) | The initialization time for the forecast. Default: latest initialization time |
| Name | Type | Description |
|---|---|---|
| coordinates Required | string (lat,lon;...) | Latitude,longitude pairs separated by semicolons, for example 37,-121;40.3,-100. Results preserve the input order. On wm-6-3km, coordinates must fall within the model's bounding box. Range: latitude −90° to 90°, longitude −180° to 180° |
| -m , --model Optional | string | Weather model to use. Allowed: wm-6, wm-6-3km, ecmwf-det, ecmwf-ens, aifs, gfs, hrrr |
| -v , --variable Optional | string | Comma-separated model variable(s) to interpolate instead of the default variable set. On WM-6, request a native variable (e.g., temperature_2m) or a derived variable (e.g., thermal_strength) by name; for upper-level variables, also specify level. Derived variables are not included in the default set and are available only for non-archived forecasts. Use the Variables endpoint to list what's available. |
| -l , --level Optional | integer | Pressure level for an upper-level variable, in hPa. See Variables for the levels available for the selected model. Models: wm-6; Unit: hPa |
| --include-distribution Optional | flag | If true, adds distribution outputs such as percentiles, standard deviation, thresholds, and precipitation-type probabilities. Requires variable to be set to a single variable. Models: wm-6; Default: false |
| -mt , --min-time Optional | string (ISO 8601) | Earliest valid time to include in the response. |
| -xt , --max-time Optional | string (ISO 8601) | Latest valid time to include in the response. |
| -mh , --min-hour Optional | integer | Earliest forecast hour to include in the response, counted from forecast zero. Unit: hours |
| -xh , --max-hour Optional | integer | Latest forecast hour to include in the response, counted from forecast zero. Unit: hours |
| -i , --init-time Optional | string (ISO 8601) | The initialization time for the forecast. Default: latest initialization time |
| output_file Optional | string | Path to save the response data. File extension determines format: .csv or .json. If omitted, prints to stdout. |
| Name | Type | Description |
|---|---|---|
| coordinates Required | str | list[tuple] | Latitude,longitude pairs separated by semicolons, for example 37,-121;40.3,-100. Results preserve the input order. On wm-6-3km, coordinates must fall within the model's bounding box. Also accepts a list of (lat, lon) tuples. Range: latitude −90° to 90°, longitude −180° to 180° |
| model Optional | str | Weather model to use. Allowed: wm-6, wm-6-3km, ecmwf-det, ecmwf-ens, aifs, gfs, hrrr |
| variable Optional | str | Comma-separated model variable(s) to interpolate instead of the default variable set. On WM-6, request a native variable (e.g., temperature_2m) or a derived variable (e.g., thermal_strength) by name; for upper-level variables, also specify level. Derived variables are not included in the default set and are available only for non-archived forecasts. Use the Variables endpoint to list what's available. |
| level Optional | int | Pressure level for an upper-level variable, in hPa. See Variables for the levels available for the selected model. Models: wm-6; Unit: hPa |
| include_distribution Optional | bool | If true, adds distribution outputs such as percentiles, standard deviation, thresholds, and precipitation-type probabilities. Requires variable to be set to a single variable. Models: wm-6; Default: false |
| min_forecast_time Optional | str (ISO 8601) | Earliest valid time to include in the response. |
| max_forecast_time Optional | str (ISO 8601) | Latest valid time to include in the response. |
| min_forecast_hour Optional | int | Earliest forecast hour to include in the response, counted from forecast zero. Unit: hours |
| max_forecast_hour Optional | int | Latest forecast hour to include in the response, counted from forecast zero. Unit: hours |
| initialization_time Optional | str (ISO 8601) | The initialization time for the forecast. Default: latest initialization time |
| output_file Optional | str | Path to save the response data. File extension determines format: .csv or .json. |
| print_response Optional | bool | If true, prints the response data. Default: false |
When variable is supplied, the requested variables replace the default weather fields. time, latitude, and longitude remain present.
| Name | Type | Description |
|---|---|---|
| forecasts | object[][] | Forecasts, in the same order as the input coordinates. |
| time | string (ISO 8601) | When this forecast point is valid. |
| latitude | number | Latitude. Unit: degrees |
| longitude | number | Longitude. Unit: degrees |
| temperature_2m | number | null | Air temperature at 2 meters. Unit: °C |
| dewpoint_2m | number | null | Dewpoint temperature at 2 meters. Unit: °C |
| pressure_msl | number | null | Atmospheric pressure reduced to mean sea level. Unit: hPa |
| precipitation | number | null | Precipitation accumulation. The accumulation period depends on the model. Unit: mm |
| wind_u_10m | number | null | Eastward wind component at 10 meters. Unit: m/s |
| wind_v_10m | number | null | Northward wind component at 10 meters. Unit: m/s |
| wind_speed_10m | number | null | Wind speed at 10 meters. Unit: m/s |
| wind_u_100m | number | null | Eastward wind component at 100 meters. Unit: m/s |
| wind_v_100m | number | null | Northward wind component at 100 meters. Unit: m/s |
| wind_speed_100m | number | null | Wind speed at 100 meters. Unit: m/s |
| <variable> | number | string | null | Value of the requested variable. p_type returns a precipitation-type name as a string; other variables return a number. Null when unavailable. |
| distribution | object | Ensemble distribution statistics for the variable. Present when: include_distribution=true |
| mean | number | Ensemble mean. For p_type, the most probable precipitation-type code: 0 rain, 1 freezing rain, 2 ice pellets, 3 snow. |
| std | number | Ensemble standard deviation. |
| p01 , p05 , p10 , p25 , p75 , p90 , p95 , p99 | number | Ensemble percentiles. |
| gt_0p25mm , gt_2p5mm , gt_6mm , gt_12p5mm , gt_25mm , gt_50mm | number | Ensemble probability of exceeding the given precipitation threshold. Present when: a precipitation variable is requested |
| p_rain , p_freezing_rain , p_ice_pellets , p_snow | number | Ensemble probability for each precipitation type. Present when: variable=p_type |
| initialization_time | string (ISO 8601) | The forecast initialization time. |
| forecast_zero | string (ISO 8601) | Valid time of forecast hour 0. |
| filtered_coordinates | integer[] | Indices of requested coordinates excluded by geographic access rules. |
| Name | Type | Description |
|---|---|---|
| forecasts | object[][] | Forecasts, in the same order as the input coordinates. |
| time | string (ISO 8601) | When this forecast point is valid. |
| latitude | number | Latitude. Unit: degrees |
| longitude | number | Longitude. Unit: degrees |
| temperature_2m | number | null | Air temperature at 2 meters. Unit: °C |
| dewpoint_2m | number | null | Dewpoint temperature at 2 meters. Unit: °C |
| pressure_msl | number | null | Atmospheric pressure reduced to mean sea level. Unit: hPa |
| precipitation | number | null | Precipitation accumulation. The accumulation period depends on the model. Unit: mm |
| wind_u_10m | number | null | Eastward wind component at 10 meters. Unit: m/s |
| wind_v_10m | number | null | Northward wind component at 10 meters. Unit: m/s |
| wind_speed_10m | number | null | Wind speed at 10 meters. Unit: m/s |
| wind_u_100m | number | null | Eastward wind component at 100 meters. Unit: m/s |
| wind_v_100m | number | null | Northward wind component at 100 meters. Unit: m/s |
| wind_speed_100m | number | null | Wind speed at 100 meters. Unit: m/s |
| <variable> | number | string | null | Value of the requested variable. p_type returns a precipitation-type name as a string; other variables return a number. Null when unavailable. |
| initialization_time | string (ISO 8601) | The forecast initialization time. |
| forecast_zero | string (ISO 8601) | Valid time of forecast hour 0. |
| filtered_coordinates | integer[] | Indices of requested coordinates excluded by geographic access rules. |
| Name | Type | Description |
|---|---|---|
| forecasts | object[][] | Forecasts, in the same order as the input coordinates. |
| time | string (ISO 8601) | When this forecast point is valid. |
| latitude | number | Latitude. Unit: degrees |
| longitude | number | Longitude. Unit: degrees |
| temperature_2m | number | null | Air temperature at 2 meters. Unit: °C |
| dewpoint_2m | number | null | Dewpoint temperature at 2 meters. Unit: °C |
| pressure_msl | number | null | Atmospheric pressure reduced to mean sea level. Unit: hPa |
| precipitation | number | null | Precipitation accumulation. The accumulation period depends on the model. Unit: mm |
| wind_u_10m | number | null | Eastward wind component at 10 meters. Unit: m/s |
| wind_v_10m | number | null | Northward wind component at 10 meters. Unit: m/s |
| wind_speed_10m | number | null | Wind speed at 10 meters. Unit: m/s |
| wind_u_100m | number | null | Eastward wind component at 100 meters. Unit: m/s |
| wind_v_100m | number | null | Northward wind component at 100 meters. Unit: m/s |
| wind_speed_100m | number | null | Wind speed at 100 meters. Unit: m/s |
| <variable> | number | string | null | Value of the requested variable. p_type returns a precipitation-type name as a string; other variables return a number. Null when unavailable. |
| initialization_time | string (ISO 8601) | The forecast initialization time. |
| forecast_zero | string (ISO 8601) | Valid time of forecast hour 0. |
| filtered_coordinates | integer[] | Indices of requested coordinates excluded by geographic access rules. |
| Name | Type | Description |
|---|---|---|
| forecasts | object[][] | Forecasts, in the same order as the input coordinates. |
| time | string (ISO 8601) | When this forecast point is valid. |
| latitude | number | Latitude. Unit: degrees |
| longitude | number | Longitude. Unit: degrees |
| temperature_2m | number | null | Air temperature at 2 meters. Unit: °C |
| dewpoint_2m | number | null | Dewpoint temperature at 2 meters. Unit: °C |
| pressure_msl | number | null | Atmospheric pressure reduced to mean sea level. Unit: hPa |
| precipitation | number | null | Precipitation accumulation. The accumulation period depends on the model. Unit: mm |
| wind_u_10m | number | null | Eastward wind component at 10 meters. Unit: m/s |
| wind_v_10m | number | null | Northward wind component at 10 meters. Unit: m/s |
| wind_speed_10m | number | null | Wind speed at 10 meters. Unit: m/s |
| wind_u_100m | number | null | Eastward wind component at 100 meters. Unit: m/s |
| wind_v_100m | number | null | Northward wind component at 100 meters. Unit: m/s |
| wind_speed_100m | number | null | Wind speed at 100 meters. Unit: m/s |
| <variable> | number | string | null | Value of the requested variable. p_type returns a precipitation-type name as a string; other variables return a number. Null when unavailable. |
| initialization_time | string (ISO 8601) | The forecast initialization time. |
| forecast_zero | string (ISO 8601) | Valid time of forecast hour 0. |
| filtered_coordinates | integer[] | Indices of requested coordinates excluded by geographic access rules. |
| Name | Type | Description |
|---|---|---|
| forecasts | object[][] | Forecasts, in the same order as the input coordinates. |
| time | string (ISO 8601) | When this forecast point is valid. |
| latitude | number | Latitude. Unit: degrees |
| longitude | number | Longitude. Unit: degrees |
| temperature_2m | number | null | Air temperature at 2 meters. Unit: °C |
| dewpoint_2m | number | null | Dewpoint temperature at 2 meters. Unit: °C |
| pressure_msl | number | null | Atmospheric pressure reduced to mean sea level. Unit: hPa |
| precipitation | number | null | Precipitation accumulation. The accumulation period depends on the model. Unit: mm |
| wind_u_10m | number | null | Eastward wind component at 10 meters. Unit: m/s |
| wind_v_10m | number | null | Northward wind component at 10 meters. Unit: m/s |
| wind_speed_10m | number | null | Wind speed at 10 meters. Unit: m/s |
| wind_u_100m | number | null | Eastward wind component at 100 meters. Unit: m/s |
| wind_v_100m | number | null | Northward wind component at 100 meters. Unit: m/s |
| wind_speed_100m | number | null | Wind speed at 100 meters. Unit: m/s |
| <variable> | number | string | null | Value of the requested variable. p_type returns a precipitation-type name as a string; other variables return a number. Null when unavailable. |
| initialization_time | string (ISO 8601) | The forecast initialization time. |
| forecast_zero | string (ISO 8601) | Valid time of forecast hour 0. |
| filtered_coordinates | integer[] | Indices of requested coordinates excluded by geographic access rules. |
| Name | Type | Description |
|---|---|---|
| forecasts | object[][] | Forecasts, in the same order as the input coordinates. |
| time | string (ISO 8601) | When this forecast point is valid. |
| latitude | number | Latitude. Unit: degrees |
| longitude | number | Longitude. Unit: degrees |
| temperature_2m | number | null | Air temperature at 2 meters. Unit: °C |
| dewpoint_2m | number | null | Dewpoint temperature at 2 meters. Unit: °C |
| pressure_msl | number | null | Atmospheric pressure reduced to mean sea level. Unit: hPa |
| precipitation | number | null | Precipitation accumulation. The accumulation period depends on the model. Unit: mm |
| wind_u_10m | number | null | Eastward wind component at 10 meters. Unit: m/s |
| wind_v_10m | number | null | Northward wind component at 10 meters. Unit: m/s |
| wind_speed_10m | number | null | Wind speed at 10 meters. Unit: m/s |
| wind_u_100m | number | null | Eastward wind component at 100 meters. Unit: m/s |
| wind_v_100m | number | null | Northward wind component at 100 meters. Unit: m/s |
| wind_speed_100m | number | null | Wind speed at 100 meters. Unit: m/s |
| <variable> | number | string | null | Value of the requested variable. p_type returns a precipitation-type name as a string; other variables return a number. Null when unavailable. |
| initialization_time | string (ISO 8601) | The forecast initialization time. |
| forecast_zero | string (ISO 8601) | Valid time of forecast hour 0. |
| filtered_coordinates | integer[] | Indices of requested coordinates excluded by geographic access rules. |
| Name | Type | Description |
|---|---|---|
| forecasts | object[][] | Forecasts, in the same order as the input coordinates. |
| time | string (ISO 8601) | When this forecast point is valid. |
| latitude | number | Latitude. Unit: degrees |
| longitude | number | Longitude. Unit: degrees |
| temperature_2m | number | null | Air temperature at 2 meters. Unit: °C |
| dewpoint_2m | number | null | Dewpoint temperature at 2 meters. Unit: °C |
| pressure_msl | number | null | Atmospheric pressure reduced to mean sea level. Unit: hPa |
| precipitation | number | null | Precipitation accumulation. The accumulation period depends on the model. Unit: mm |
| wind_u_10m | number | null | Eastward wind component at 10 meters. Unit: m/s |
| wind_v_10m | number | null | Northward wind component at 10 meters. Unit: m/s |
| wind_speed_10m | number | null | Wind speed at 10 meters. Unit: m/s |
| wind_u_100m | number | null | Eastward wind component at 100 meters. Unit: m/s |
| wind_v_100m | number | null | Northward wind component at 100 meters. Unit: m/s |
| wind_speed_100m | number | null | Wind speed at 100 meters. Unit: m/s |
| <variable> | number | string | null | Value of the requested variable. p_type returns a precipitation-type name as a string; other variables return a number. Null when unavailable. |
| initialization_time | string (ISO 8601) | The forecast initialization time. |
| forecast_zero | string (ISO 8601) | Valid time of forecast hour 0. |
| filtered_coordinates | integer[] | Indices of requested coordinates excluded by geographic access rules. |
On WeatherMesh 6, precipitation is the total precipitation over the 3 hours ending at time.
On WeatherMesh 6 3 km, pressure_msl and precipitation are returned as null. wind_speed_10m is calculated from wind_u_10m and wind_v_10m.