Data Portal Web Service Documentation

Resources available from the WDC web service at https://app-geomag.bgs.ac.uk/wdc :

All Observatories

Retrieve a list of all observatory stations known to the WDC

Endpoint Request Parameters Example
/stations GET https://app-geomag.bgs.ac.uk/wdc/stations

Observatory Metadata

Retrieve basic metadata for the observatory station with the given IAGA code

Endpoint Request Parameters Example
/stations/{code} GET {code}: string (IAGA observatory code) https://app-geomag.bgs.ac.uk/wdc/stations/ESK

Catalogue Query

Query the WDC data catalogue

Endpoint Request Parameters Example
/catalogue/search? GET
  • minYear: filter for minimum year in catalogue, integer (YYYY)
  • maxYear: filter for maximum year in catalogue, integer (YYYY)
  • minLatitude: filter for minimum latitude in catalogue, decimal (degrees)
  • maxLatitude: filter for maximum latitude in catalogue, decimal (degrees)
  • minLongitude: filter for minimum longitude in catalogue, decimal (degrees)
  • maxLongitude: filter for maximum longitude in catalogue, decimal (degrees)
  • stations: filter for observatory stations in catalogue, string list (IAGA code)
  • frequencyTypes: filter for cadences in catalogue, string list (HOUR, MINUTE)
https://app-geomag.bgs.ac.uk/wdc/catalogue/search?minYear=2000&maxYear=2013&stations=LER,ESK&frequencyTypes=MINUTE

Observatory Data

Retrieve a particular dataset for an observatory

Endpoint Request Parameters Example
/datasets/{frequency}/{id}? GET
  • {frequency}: cadence, string ('hour' or 'minute')
  • {id}: dataset identifier, string (IAGAcodeYYYY (example ESK1985) for hour data or IAGAcodeYYYYMM (example ESK198512) for minute data)
  • media: data format, string ('xml' (default), 'json', 'csv', 'wdc', 'iaga2002')
https://app-geomag.bgs.ac.uk/wdc/datasets/hour/esk1985

https://app-geomag.bgs.ac.uk/wdc/datasets/minute/esk198512?media=iaga2002