Skip to main content

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 callWeather Stations v2 equivalent
GET /weatherStation/{stationId}/latestGET /weather-stations/v2/stations/{station_id}/observations/latest
GET /weatherStation/{stationId}/last/{minutes}/minutesGET /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 /weatherStationGET /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 v2Notes
airtemp_01mnavgair_temperature_1min_mean→
airtemp_01hrmaxair_temperature_1h_max→
airtemp_01hrminair_temperature_1h_min→
dewtemp_01mnavgdew_point_temperature_1min_mean→
windspd_01mnavgwind_speed_1min_mean→
windspd_10mnavgwind_speed_10min_mean→
windspd_01hravgwind_speed_1h_mean→
winddir_01mnavgwind_from_direction_1min_mean→
winddir_10mnavgwind_from_direction_10min_mean→
winddir_01hravgwind_from_direction_1h_mean→
windgst_01mnmaxwind_gust_speed_1min_max→
windgst_10mnmaxwind_gust_speed_10min_max→
windgst_01hrmaxwind_gust_speed_1h_max→
windgst_01hrdirwind_gust_from_direction_1h→
windgst_01hrtimwind_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_01mnminwind_lull_speed_1min_min→
windlul_10mnminwind_lull_speed_10min_min→
windrun_01hraccwind_run_1h_sum⚠ Legacy labels this m, but the values are kilometres; v2 labels them km. Values are unchanged
presmsl_01mnavgmsl_pressure_1min_mean→
presmsl_01hrmaxmsl_pressure_1h_max→
presmsl_01hrminmsl_pressure_1h_min→
relhumd_01mnavgrelative_humidity_1min_mean→
relhumd_01hrmaxrelative_humidity_1h_max→
relhumd_01hrminrelative_humidity_1h_min→
rainfal_01mnaccrainfall_1min_sum→
rainfal_10mnaccrainfall_10min_sum→
rainfal_01hraccrainfall_1h_sum→
rainfal_10mnmaxrainfall_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_01hrmaxrainfall_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_01mnavgsoil_temperature_2cm_1min_mean→
earth05_01mnavgsoil_temperature_5cm_1min_mean→
earth10_01mnavgsoil_temperature_10cm_1min_mean→
earth20_01mnavgsoil_temperature_20cm_1min_mean→
earth50_01mnavgsoil_temperature_50cm_1min_mean→
earth1m_01mnavgsoil_temperature_1m_1min_mean→
soilwet_01mnavgsoil_moisture_1min_mean→
solradn_01mnavgsolar_irradiance_1min_mean→
solradn_01mnaccsolar_irradiance_1min_sum→
solradn_10mnaccsolar_irradiance_10min_sum→
solradn_01hraccsolar_irradiance_1h_sum→
visibil_01mnavgvisibility_1min_mean⚠ Legacy returns text with a unit (for example "7 km" or "658 m"); v2 returns a whole number of metres
visibil_10mnavgvisibility_10min_mean⚠ Legacy returns text with a unit (for example "7 km" or "658 m"); v2 returns a whole number of metres
cld1amt_30mnavgcloud_fraction_layer_1_30min_mean→
cld1hgt_30mnavgcloud_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_30mnavgcloud_fraction_layer_2_30min_mean→
cld2hgt_30mnavgcloud_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_30mnavgcloud_fraction_layer_3_30min_mean→
cld3hgt_30mnavgcloud_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_01mnavgsnow_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_01mnavgroad_surface_temperature_1min_mean→ Same road-surface sensor type, at road weather stations and at airports
sfctemp_01hrminroad_surface_temperature_1h_min→ Same road-surface sensor type, at road weather stations and at airports
road_t1_01mnavgroad_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_01mnavgroad_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_01mnavgroad_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_10mnavgroad_subsurface_temperature_5cm_10min_mean→ Road weather stations only
road_t2_10mnavgroad_subsurface_temperature_30cm_10min_mean→ Road weather stations only
road_t3_10mnavgroad_subsurface_temperature_2cm_10min_mean→ Road weather stations only
roadflm_01mnavgroad_water_film_height_1min_mean→ Road weather stations only
roadflm_10mnavgroad_water_film_height_10min_mean→ Road weather stations only
roadtxt_01mnavgroad_surface_state→ Road weather stations only. Text value passed through unchanged (for example "Dry")
roadcdn_01mnavgroad_condition_code⚠ Road weather stations only. Numeric road condition code, passed through unchanged
roadsst_01mnavgroad_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_timestampobservation_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_01mnaccsunshine_duration_1min_sum→ Unit s
britsun_01hraccsunshine_duration_1h_sum⚠ Legacy is in minutes; v2 returns seconds (legacy value × 60)
latitude / longitudeper-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_rnwayabvmslcatalogue station.elevationApproximate; provided as static station metadata in the catalogue
stn_magneticdevcatalogue 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_01mnavgaerodrome_level_pressure_1min_mean⚠ QFE. Air pressure at aerodrome level
presqfe_01hrmaxaerodrome_level_pressure_1h_max⚠ QFE. Air pressure at aerodrome level
presqfe_01hrminaerodrome_level_pressure_1h_min⚠ QFE. Air pressure at aerodrome level
presqnh_01mnavgaltimeter_setting_pressure_1min_mean⚠ QNH. Not the same as msl_pressure (mean sea level pressure)
presqnh_01hrmaxaltimeter_setting_pressure_1h_max⚠ QNH. Not the same as msl_pressure (mean sea level pressure)
presqnh_01hrminaltimeter_setting_pressure_1h_min⚠ QNH. Not the same as msl_pressure (mean sea level pressure)
pressen_01mnavgstation_pressure_1min_mean→ Pressure at the sensor height
pressen_01hrmaxstation_pressure_1h_max→ Pressure at the sensor height
pressen_01hrminstation_pressure_1h_min→ Pressure at the sensor height
pressen_01hrchgstation_pressure_change_1h→
prwxnum_15mnavgpresent_weather_synop_code_15min⚠ Legacy "//" (not observed) is returned as null
prwxst1_15mnavgpresent_weather_metar_code_15min⚠ Legacy "//" (not observed) is returned as null
prwxst2_15mnavg—Not in v2. No station currently reports it
road_fz_01mnavgroad_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_01mnavgroad_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_15mnavgrecent_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_01mnmaxwind_from_direction_counterclockwise_limit_1min⚠ Legacy calls this a "deviation"; the value is a bearing (the furthest counterclockwise direction the wind came from)
windccw_10mnmaxwind_from_direction_counterclockwise_limit_10min⚠ Legacy calls this a "deviation"; the value is a bearing (the furthest counterclockwise direction the wind came from)
windccw_01hrmaxwind_from_direction_counterclockwise_limit_1h⚠ Legacy calls this a "deviation"; the value is a bearing (the furthest counterclockwise direction the wind came from)
windcw__01mnmaxwind_from_direction_clockwise_limit_1min⚠ Legacy calls this a "deviation"; the value is a bearing (the furthest clockwise direction the wind came from)
windcw__10mnmaxwind_from_direction_clockwise_limit_10min⚠ Legacy calls this a "deviation"; the value is a bearing (the furthest clockwise direction the wind came from)
windcw__01hrmaxwind_from_direction_clockwise_limit_1h⚠ Legacy calls this a "deviation"; the value is a bearing (the furthest clockwise direction the wind came from)
wnddirm_01mnavgwind_from_direction_magnetic_1min_mean→ Measured from magnetic north (degrees_magnetic)
wnddirm_10mnavgwind_from_direction_magnetic_10min_mean→ Measured from magnetic north (degrees_magnetic)
wnddirm_01hravgwind_from_direction_magnetic_1h_mean→ Measured from magnetic north (degrees_magnetic)
wndgstm_01hrdirwind_gust_from_direction_magnetic_1h→ Measured from magnetic north (degrees_magnetic)
wndccwm_01mnmaxwind_from_direction_magnetic_counterclockwise_limit_1min⚠ Magnetic version of the counterclockwise limit; measured from magnetic north
wndccwm_10mnmaxwind_from_direction_magnetic_counterclockwise_limit_10min⚠ Magnetic version of the counterclockwise limit; measured from magnetic north
wndccwm_01hrmaxwind_from_direction_magnetic_counterclockwise_limit_1h⚠ Magnetic version of the counterclockwise limit; measured from magnetic north
wndcwm__01mnmaxwind_from_direction_magnetic_clockwise_limit_1min⚠ Magnetic version of the clockwise limit; measured from magnetic north
wndcwm__10mnmaxwind_from_direction_magnetic_clockwise_limit_10min⚠ Magnetic version of the clockwise limit; measured from magnetic north
wndcwm__01hrmaxwind_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.