Example Requests

BOU observatory data for current UTC day in IAGA2002 format
http://geomag.usgs.gov/ws/edge/?id=BOU
BOU observatory data for current UTC day in JSON format
http://geomag.usgs.gov/ws/edge/?id=BOU&format=json

Request Limits

To ensure availablility for users, the web service restricts the amount of data that can be retrieved in one request. The amount of data requested is computed as follows, where interval is the number of seconds between starttime and endtime:

  samples = count(elements) * interval / sampling_period

Limits by output format

json
172800 samples = 4 elements * 12 hours * 3600 samples/hour.
iaga2002
345600 samples = 4 elements * 24 hours * 3600 samples/hour.

NOTE: while the json format supports fewer total samples per request, users may request fewer elements to retrieve longer intervals.

Parameters

id
Observatory code. Required.
Valid values: BDT, BOU, TST, BRW, BRT, BSL, CMO, CMT, DED, DHT, FRD, FRN, GUA, HON, NEW, SHU, SIT, SJG, TUC, USGS, BLC, BRD, CBB, EUA, FCC, IQA, MEA, OTT, RES, SNK, STJ, VIC, YKC, HAD, HER, KAK
starttime
Time of first requested data.
Default: start of current UTC day
Format: ISO8601 (YYYY-MM-DDTHH:MM:SSZ)
Example: 2017-09-20T16:25:37Z
endtime
Time of last requested data.
Default: starttime + 24 hours
Format: ISO8601 (YYYY-MM-DDTHH:MM:SSZ)
Example: 2017-09-20T16:25:37Z
elements
Comma separated list of requested elements.
Default: X,Y,Z,F
sampling_period
Interval in seconds between values.
Default: 60
Valid values: 1, 60, 3600
type
Type of data.
Default: variation Valid values: variation, adjusted, quasi-definitive, definitive
NOTE: the USGS web service also supports specific EDGE location codes. For example: R0 is "internet variation", R1 is "satellite variation".
format
Output format.
Default: iaga2002
Valid values: iaga2002, json.