Retrieve interpolated forecast sounding data (vertical atmospheric profiles) for a specific geographic coordinate. This endpoint provides predicted temperature, humidity, and wind data at multiple pressure levels, suitable for generating Skew-T diagrams and atmospheric analysis.
This endpoint is available for the same forecast hours that contain upper-level variables. See the Variables and Gridded Forecast endpoints for more details.
Use the model-specific URL below to choose which weather model's forecast to retrieve. Only models with upper-level atmospheric variables are supported.
| Name | Type | Description |
|---|---|---|
| coordinates Required | string (lat,lon) | A single latitude,longitude coordinate for the sounding location. Range: latitude −90° to 90°, longitude −180° to 180° |
| time Conditional | string (ISO 8601) | The time at which the forecast is valid. Alternatively, you can specify initialization_time and forecast_hour. |
| initialization_time Conditional | string (ISO 8601) | The initialization time for the forecast. Must be used with forecast_hour. Cannot be used with time. |
| forecast_hour Conditional | integer | Hours from forecast zero for which to get the forecast. Must be used with initialization_time. Cannot be used with time. Unit: hours |
| Name | Type | Description |
|---|---|---|
| coordinates Required | string (lat,lon) | A single latitude,longitude coordinate for the sounding location. Range: latitude −90° to 90°, longitude −180° to 180° |
| -m , --model Required | string | Weather model to use. Allowed: wm-6 |
| -t , --time Conditional | string (ISO 8601) | The time at which the forecast is valid. Alternatively, you can specify initialization_time and forecast_hour. |
| -i , --init-time Conditional | string (ISO 8601) | The initialization time for the forecast. Must be used with forecast_hour. Cannot be used with time. |
| -fh , --forecast-hour Conditional | integer | Hours from forecast zero for which to get the forecast. Must be used with initialization_time. Cannot be used with time. Unit: hours |
| 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 | tuple | A single latitude,longitude coordinate for the sounding location. Also accepts a (lat, lon) tuple. Range: latitude −90° to 90°, longitude −180° to 180° |
| model Required | str | Weather model to use. Allowed: wm-6 |
| time Conditional | str (ISO 8601) | The time at which the forecast is valid. Alternatively, you can specify initialization_time and forecast_hour. |
| initialization_time Conditional | str (ISO 8601) | The initialization time for the forecast. Must be used with forecast_hour. Cannot be used with time. |
| forecast_hour Conditional | int | Hours from forecast zero for which to get the forecast. Must be used with initialization_time. Cannot be used with time. Unit: hours |
| 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 |
Returns interpolated forecast sounding data with atmospheric measurements at different pressure levels.
| Name | Type | Description |
|---|---|---|
| initialization_time | string (ISO 8601) | The forecast initialization time. |
| forecast_zero | string (ISO 8601) | Valid time of forecast hour 0. |
| time | string (ISO 8601) | When this forecast point is valid. |
| forecast_hour | integer | Hours since forecast_zero. Valid time = forecast_zero + forecast_hour. Unit: hours |
| latitude | number | Latitude. Unit: degrees |
| longitude | number | Longitude. Unit: degrees |
| data | object[] | Atmospheric data at different pressure levels. |
| pressure_hpa | number | Atmospheric pressure. Unit: hPa |
| altitude_m | number | Altitude above mean sea level. Calculated from geopotential height. Unit: meters |
| temperature_c | number | Air temperature. Unit: °C |
| dewpoint_c | number | Dewpoint. Calculated from temperature and relative humidity. Unit: °C |
| specific_humidity_kg_kg | number | Specific humidity. Unit: kg/kg |
| wind_u_ms | number | Eastward wind component. Direction of increasing longitude. Unit: m/s |
| wind_v_ms | number | Northward wind component. Direction of increasing latitude. Unit: m/s |