Migrating from the 1-Minute Observations API
This page is for developers moving an existing integration from the legacy 1-Minute Observations API to the Weather Stations API. If you're integrating for the first time, you don't need anything on this page — everything here concerns a predecessor API you were never on.
The legacy API remains available with no sunset date. Migrating gets you a bulk latest-observations endpoint, relative time windowing (last_minutes), and observation-interval control (timestep), none of which the legacy API supports.
Request shape
The legacy API baked the time mode into the URL path. In v2 the same choice is a query parameter on one consistent path:
| Legacy 1-Minute Observations call | Weather Stations v2 equivalent |
|---|---|
GET /weatherStation/{stationId}/latest | GET /weather-stations/v2/stations/{station_id}/observations/latest |
GET /weatherStation/{stationId}/last/{minutes}/minutes | GET /weather-stations/v2/stations/{station_id}/observations?last_minutes={minutes} |
GET /weatherStation/{stationId}/range/{fromDateTime}/{toDateTime} | GET /weather-stations/v2/stations/{station_id}/observations?from_date_time={fromDateTime}&to_date_time={toDateTime} |
GET /weatherStation | GET /weather-stations/v2/stations |
| (no equivalent) | GET /weather-stations/v2/stations/observations/latest — every station your key can access in one call, no station list to build |
For the current request parameters and response shape, see the Weather Stations API guide and the Technical Reference.
Variable names
Every variable name has changed. If you have alarm or threshold rules that embed a variable name — for example "alarm when windspd_01mnavg > 80" — swap the name for the v2 equivalent ("alarm when wind_speed_1min_mean > 80"). Units are unchanged unless the Notes column below says otherwise. Unit labels now use WMO Common Code Table C-6 codes, so some labels change while the values don't: knot is now kt, deg is now degrees_true (or degrees_magnetic for the magnetic fields), W.m^{-2} is now W_m-2 and MJ.m^{-2} is now MJ_m-2.
Legend: → direct equivalent · ⚠ unit or semantic difference (see Notes) · — no v2 equivalent.
A few legacy fields are mapped but aren't on the Variables page yet. Either no station reports them today (the v2 name and unit are fixed so they're ready if a station starts sending them), or their meaning or unit is still being confirmed.
| Legacy (1-Min Obs) | Weather Stations v2 | Notes |
|---|---|---|
airtemp_01mnavg | air_temperature_1min_mean | → |
airtemp_01hrmax | air_temperature_1h_max | → |
airtemp_01hrmin | air_temperature_1h_min | → |
dewtemp_01mnavg | dew_point_temperature_1min_mean | → |
windspd_01mnavg | wind_speed_1min_mean | → |
windspd_10mnavg | wind_speed_10min_mean | → |
windspd_01hravg | wind_speed_1h_mean | → |
winddir_01mnavg | wind_from_direction_1min_mean | → |
winddir_10mnavg | wind_from_direction_10min_mean | → |
winddir_01hravg | wind_from_direction_1h_mean | → |
windgst_01mnmax | wind_gust_speed_1min_max | → |
windgst_10mnmax | wind_gust_speed_10min_max | → |
windgst_01hrmax | wind_gust_speed_1h_max | → |
windgst_01hrdir | wind_gust_from_direction_1h | → |
windgst_01hrtim | wind_gust_peak_time_1h | ⚠ Legacy is the gust time as an HHMM UTC integer (for example 1942 = 19:42Z, 13 = 00:13Z); v2 returns a full ISO 8601 UTC timestamp |
windlul_01mnmin | wind_lull_speed_1min_min | → |
windlul_10mnmin | wind_lull_speed_10min_min | → |
windrun_01hracc | wind_run_1h_sum | ⚠ Legacy labels this m, but the values are kilometres; v2 labels them km. Values are unchanged |
presmsl_01mnavg | msl_pressure_1min_mean | → |
presmsl_01hrmax | msl_pressure_1h_max | → |
presmsl_01hrmin | msl_pressure_1h_min | → |
relhumd_01mnavg | relative_humidity_1min_mean | → |
relhumd_01hrmax | relative_humidity_1h_max | → |
relhumd_01hrmin | relative_humidity_1h_min | → |
rainfal_01mnacc | rainfall_1min_sum | → |
rainfal_10mnacc | rainfall_10min_sum | → |
rainfal_01hracc | rainfall_1h_sum | → |
rainfal_10mnmax | rainfall_rate_10min_max | ⚠ Unit label changes from mm to mm_min-1; values are unchanged. Both report the largest rainfall in any single minute during the last 10 minutes, so X mm in one minute is X mm/min |
rainfal_01hrmax | rainfall_rate_1h_max | ⚠ Unit label changes from mm to mm_min-1; values are unchanged. Both report the largest rainfall in any single minute during the last 60 minutes, so X mm in one minute is X mm/min |
earth02_01mnavg | soil_temperature_2cm_1min_mean | → |
earth05_01mnavg | soil_temperature_5cm_1min_mean | → |
earth10_01mnavg | soil_temperature_10cm_1min_mean | → |
earth20_01mnavg | soil_temperature_20cm_1min_mean | → |
earth50_01mnavg | soil_temperature_50cm_1min_mean | → |
earth1m_01mnavg | soil_temperature_1m_1min_mean | → |
soilwet_01mnavg | soil_moisture_1min_mean | → |
solradn_01mnavg | solar_irradiance_1min_mean | → |
solradn_01mnacc | solar_irradiance_1min_sum | → |
solradn_10mnacc | solar_irradiance_10min_sum | → |
solradn_01hracc | solar_irradiance_1h_sum | → |
visibil_01mnavg | visibility_1min_mean | ⚠ Legacy returns text with a unit (for example "7 km" or "658 m"); v2 returns a whole number of metres |
visibil_10mnavg | visibility_10min_mean | ⚠ Legacy returns text with a unit (for example "7 km" or "658 m"); v2 returns a whole number of metres |
cld1amt_30mnavg | cloud_fraction_layer_1_30min_mean | → |
cld1hgt_30mnavg | cloud_height_layer_1_30min_mean | ⚠ Legacy labels this m, but the values are feet (the global meteorological standard for cloud base); v2 labels them ft. Values are unchanged |
cld2amt_30mnavg | cloud_fraction_layer_2_30min_mean | → |
cld2hgt_30mnavg | cloud_height_layer_2_30min_mean | ⚠ Legacy labels this m, but the values are feet (the global meteorological standard for cloud base); v2 labels them ft. Values are unchanged |
cld3amt_30mnavg | cloud_fraction_layer_3_30min_mean | → |
cld3hgt_30mnavg | cloud_height_layer_3_30min_mean | ⚠ Legacy labels this m, but the values are feet (the global meteorological standard for cloud base); v2 labels them ft. Values are unchanged |
snowdep_01mnavg | snow_depth_1min_mean | → |
power_v_01mnavg | — | Not in v2. Station power supply voltage is station-engineering data and is not part of the public observations contract |
sfctemp_01mnavg | road_surface_temperature_1min_mean | → Same road-surface sensor type, at road weather stations and at airports |
sfctemp_01hrmin | road_surface_temperature_1h_min | → Same road-surface sensor type, at road weather stations and at airports |
road_t1_01mnavg | road_subsurface_temperature_5cm_1min_mean | ⚠ Road weather stations only. The legacy "air 5 cm above road" label was incorrect; v2 corrects it to 5 cm below the surface |
road_t2_01mnavg | road_subsurface_temperature_30cm_1min_mean | ⚠ Road weather stations only. The legacy "air 30 cm above road" label was incorrect; v2 corrects it to 30 cm below the surface |
road_t3_01mnavg | road_subsurface_temperature_2cm_1min_mean | ⚠ Road weather stations only. The legacy "sensor internal temperature ~2 cm" label was incorrect; v2 corrects it to 2 cm below the surface |
road_t1_10mnavg | road_subsurface_temperature_5cm_10min_mean | → Road weather stations only |
road_t2_10mnavg | road_subsurface_temperature_30cm_10min_mean | → Road weather stations only |
road_t3_10mnavg | road_subsurface_temperature_2cm_10min_mean | → Road weather stations only |
roadflm_01mnavg | road_water_film_height_1min_mean | → Road weather stations only |
roadflm_10mnavg | road_water_film_height_10min_mean | → Road weather stations only |
roadtxt_01mnavg | road_surface_state | → Road weather stations only. Text value passed through unchanged (for example "Dry") |
roadcdn_01mnavg | road_condition_code | ⚠ Road weather stations only. Numeric road condition code, passed through unchanged |
roadsst_01mnavg | road_surface_status_code | ⚠ Road weather stations only. Numeric road surface status code. Legacy sends it as a string ("1"); v2 returns an integer |
eqptemp_01mnavg | — | Not in v2. Equipment temperature is station-engineering data and is not part of the public observations contract |
obs_timestamp | observation_time | ⚠ v2 label is the right-closed window time; see also metadata.generated_at (response time) for the data-freshness/latency signal |
time (CF-JSON) | observation_time | → |
latitude, longitude (CF-JSON) | state.latitude, state.longitude | → Decimal degrees (WGS 84), in every observation response |
level (CF-JSON) | catalogue station.elevation | → Metres above mean sea level |
ds_dirn_01mnavg / ds_head_01mnavg / ds_sped_01mnavg | — | Not in v2. Mobile platform course, heading and speed |
fixlatd_01mnavg / fixlatm_01mnavg / fixlatn_01mnavg / fixlatr_01mnavg / fixlond_01mnavg / fixlone_01mnavg / fixlonm_01mnavg / fixlonr_01mnavg | — | Not in v2. Mobile platform GPS position fix |
britsun_01mnacc | sunshine_duration_1min_sum | → Unit s |
britsun_01hracc | sunshine_duration_1h_sum | ⚠ Legacy is in minutes; v2 returns seconds (legacy value × 60) |
latitude / longitude | per-station state block (also in the catalogue) | Every observation response carries the position in its state block, which is always present, so plotting an observation needs no catalogue lookup. The catalogue (GET /stations/{id}) stays the source of truth for static site metadata |
level / stn_rnwayabvmsl | catalogue station.elevation | Approximate; provided as static station metadata in the catalogue |
stn_magneticdev | catalogue station.magnetic_declination | → Restored as static station metadata, in degrees. Wind directions are served true (degrees_true); use magnetic_declination to convert to magnetic yourself |
presqfe_01mnavg | aerodrome_level_pressure_1min_mean | ⚠ QFE. Air pressure at aerodrome level |
presqfe_01hrmax | aerodrome_level_pressure_1h_max | ⚠ QFE. Air pressure at aerodrome level |
presqfe_01hrmin | aerodrome_level_pressure_1h_min | ⚠ QFE. Air pressure at aerodrome level |
presqnh_01mnavg | altimeter_setting_pressure_1min_mean | ⚠ QNH. Not the same as msl_pressure (mean sea level pressure) |
presqnh_01hrmax | altimeter_setting_pressure_1h_max | ⚠ QNH. Not the same as msl_pressure (mean sea level pressure) |
presqnh_01hrmin | altimeter_setting_pressure_1h_min | ⚠ QNH. Not the same as msl_pressure (mean sea level pressure) |
pressen_01mnavg | station_pressure_1min_mean | → Pressure at the sensor height |
pressen_01hrmax | station_pressure_1h_max | → Pressure at the sensor height |
pressen_01hrmin | station_pressure_1h_min | → Pressure at the sensor height |
pressen_01hrchg | station_pressure_change_1h | → |
prwxnum_15mnavg | present_weather_synop_code_15min | ⚠ Legacy "//" (not observed) is returned as null |
prwxst1_15mnavg | present_weather_metar_code_15min | ⚠ Legacy "//" (not observed) is returned as null |
prwxst2_15mnavg | — | Not in v2. No station currently reports it |
road_fz_01mnavg | road_freezing_temperature_1min_mean | → Unit degC. Freezing point of pure water on the road surface. Mapped in advance: no station reports it at the moment |
roadlfp_01mnavg / roadfrt_01mnavg / roadbki_01mnavg / roadcvy_01mnavg / roadssg_01mnavg | — | Not in v2. These road sensors are no longer reported (liquidus temperature, friction, black ice frequency, conductivity, surface signal) |
roadsal_01mnavg | road_salt_concentration_1min_mean | → Unit percent |
hailfal_01mnacc / hailfal_10mnacc / hailfal_01hracc | — | Not in v2. The hail sensors give unreliable values and are being turned off. Hail and snow are included in rainfall as their liquid water equivalent |
rewxst1_15mnavg | recent_weather_metar_code_15min | → Recent weather as a METAR code (for example RERA, recent rain). Code value, so no unit. Reported by a few stations; not yet on the Variables page |
winddir_xxmnper / windspd_xxmnper | — | Not in v2. The averaging period is part of each v2 variable name (for example wind_speed_10min_mean) |
wv10pht_xxmnavg, wvmaxht_xxmnmax, wvpk1ht_xxmnavg, wvpk1pd_xxmnavg, wvpk2ht_xxmnavg, wvpk2pd_xxmnavg, wvsight_xxmnavg, wvsigpd_xxmnavg, wvspect_xxmnavg, wvsplvl_xxmnavg, wvspwid_xxmnper, wvtradn_xxmnper, wvtrlvl_xxmnavg, wvzrxpd_xxmnavg | — | Not in v2. Wave measurements aren't part of the Weather Stations API |
windccw_01mnmax | wind_from_direction_counterclockwise_limit_1min | ⚠ Legacy calls this a "deviation"; the value is a bearing (the furthest counterclockwise direction the wind came from) |
windccw_10mnmax | wind_from_direction_counterclockwise_limit_10min | ⚠ Legacy calls this a "deviation"; the value is a bearing (the furthest counterclockwise direction the wind came from) |
windccw_01hrmax | wind_from_direction_counterclockwise_limit_1h | ⚠ Legacy calls this a "deviation"; the value is a bearing (the furthest counterclockwise direction the wind came from) |
windcw__01mnmax | wind_from_direction_clockwise_limit_1min | ⚠ Legacy calls this a "deviation"; the value is a bearing (the furthest clockwise direction the wind came from) |
windcw__10mnmax | wind_from_direction_clockwise_limit_10min | ⚠ Legacy calls this a "deviation"; the value is a bearing (the furthest clockwise direction the wind came from) |
windcw__01hrmax | wind_from_direction_clockwise_limit_1h | ⚠ Legacy calls this a "deviation"; the value is a bearing (the furthest clockwise direction the wind came from) |
wnddirm_01mnavg | wind_from_direction_magnetic_1min_mean | → Measured from magnetic north (degrees_magnetic) |
wnddirm_10mnavg | wind_from_direction_magnetic_10min_mean | → Measured from magnetic north (degrees_magnetic) |
wnddirm_01hravg | wind_from_direction_magnetic_1h_mean | → Measured from magnetic north (degrees_magnetic) |
wndgstm_01hrdir | wind_gust_from_direction_magnetic_1h | → Measured from magnetic north (degrees_magnetic) |
wndccwm_01mnmax | wind_from_direction_magnetic_counterclockwise_limit_1min | ⚠ Magnetic version of the counterclockwise limit; measured from magnetic north |
wndccwm_10mnmax | wind_from_direction_magnetic_counterclockwise_limit_10min | ⚠ Magnetic version of the counterclockwise limit; measured from magnetic north |
wndccwm_01hrmax | wind_from_direction_magnetic_counterclockwise_limit_1h | ⚠ Magnetic version of the counterclockwise limit; measured from magnetic north |
wndcwm__01mnmax | wind_from_direction_magnetic_clockwise_limit_1min | ⚠ Magnetic version of the clockwise limit; measured from magnetic north |
wndcwm__10mnmax | wind_from_direction_magnetic_clockwise_limit_10min | ⚠ Magnetic version of the clockwise limit; measured from magnetic north |
wndcwm__01hrmax | wind_from_direction_magnetic_clockwise_limit_1h | ⚠ Magnetic version of the clockwise limit; measured from magnetic north |
wv* (e.g. wvsight_xxmnavg, wvzrxpd_xxmnavg) | — | No v2 equivalent (wave-buoy variables) |
Technical reference
For request parameters, response schemas, and a live try-it console, see the Weather Stations API v2 — Technical Reference. You can also download the OpenAPI specification.