Skip to main content

1-Minute Observations API

The 1-Minute Observations API provides access to real-time weather observation data from MetService's network of Automatic Weather Stations, Road Sensors, and Airport Runway Sensors across New Zealand.

Overview​

This API delivers 1-minute observation data with a 60-day retention period from the time of observation. The data is collected from various sensor types including:

  • Automatic Weather Stations - Standard meteorological observations
  • Road Sensors - Road surface and atmospheric conditions
  • Airport Runway Sensors - Aviation-specific weather data

Key Features​

  • Real-time Data: Observations updated every minute
  • 60-Day History: Access to historical data up to 60 days old
  • Multiple Formats: JSON and CF-JSON (with field descriptions)
  • Flexible Queries: Latest, time-range, and historical data access
  • Station Metadata: Complete station information and identifiers

Base URL​

https://api.metservice.com/observations/nz/1-minute

Authentication​

The API supports two authentication methods:

API Key Authentication​

curl -H "apikey: your-api-key-here" \
  "https://api.metservice.com/observations/nz/1-minute/weatherStation"

Bearer Token Authentication​

curl -H "Authorization: Bearer your-bearer-token-here" \
  "https://api.metservice.com/observations/nz/1-minute/weatherStation"

Quick Start​

  1. Get API Access: Email api.queries@metservice.com
  2. List Available Stations: GET /weatherStation
  3. Get Latest Data: GET /weatherStation/{stationId}/latest
  4. Query Historical Data: GET /weatherStation/{stationId}/range/{from}/{to}

API Endpoints​

EndpointDescription
GET /weatherStationList all active weather stations
GET /weatherStation/{stationId}/latestGet latest observation for a station
GET /weatherStation/{stationId}/last/{minutes}/minutesGet last N minutes of data
GET /weatherStation/{stationId}/range/{from}/{to}Get data for a specific time range

Station Identifiers​

Stations can be identified using either:

  • WMO ID: World Meteorological Organisation numeric identifier (e.g., 93110)
  • ICAO ID: International Civil Aviation Organization alphabetic identifier (e.g., NZKTA)

Data Retention​

  • Retention Period: 60 days from observation time
  • Update Frequency: Every minute
  • Historical Queries: Searches beyond 60 days return no results

Next Steps​

Support​

For API access requests or technical support, contact: Email: api.queries@metservice.com