Service International des Indices Géomagnétiques
International Service of Geomagnetic Indices

ISGI web service documentation

ISGI provides a Web Service for scientific structures, organizations and institutions that request it.
The ISGI Web Service allows retrieving geomagnetic indices and events in a regular automated way.

The data you will download via this web service are, for each geomagnetic index/event, the most successfully completed data on the period requested (definitive data are primarily taken into account, then the provisional and to finish the quicklook ones).
The data requested will be sent to you as a data archive (zip) file.
If an error occurs (due to bad parameters and/or a too large amount of data) or if there’s no data available for the period requested, the service will return a text file describing the error.

Examples of ISGI's web service use

Request of magnetic activity index aa for the last past 7 days in IAGA2002 format:

https://isgi.unistra.fr/ws?user=token&index=aa

Request of magnetic activity index aa from 2015-08-01 to 2015-08-31 in IAGA2002 format

https://isgi.unistra.fr/ws?user=token&index=aa&StartTime=2015-08-01&EndTime=2015-08-31

Parameters

 
token ID sent to you by ISGI headquarters
Mandatory item
Format: string
 
index Requested magnetic activity index or event list
Mandatory item
Format: string
Example for magnetic activity index: 'aa'
Example for list of remarkable geomagnetic event: 'SC'
 
StartTime Time of first requested data
Default: Current UTC day - 7 days
Format: string ISO8601 (YYYY-MM-DD)
Example: '2017-05-01'
 
EndTime Time of last requested data
Default: Current UTC day
Format: string ISO8601 (YYYY-MM-DD)
Example: '2017-05-09'
 
Format Data format
Default: IAGA2002 enclosed in zip archive
Format: string
Example: 'iaga2002'

Request Limits

To ensure availability for users, the web service restricts the amount of data that can be retrieved in one request. The amount of data requested is limited to one year.

Note on Web service availability

Please, note that: ISGI cannot guarantee Service Level Specifications (SLS) other than "best effort".
ISGI cannot go further than to provide data of high scientific quality. ISGI have no permanence, no penalty, no legally binding obligation of service. ISGI is not achieving supervision 24h/24h, ISGI is doing observation. ISGI is an International service of the International Association of Geomagnetis and Aeronomy which primary customers belong to research domain, mainly academic.
ISGI, through the ISGI Collaborating Institutes, has the responsibility of IAGA geomagnetic indices derivation and dissemination, and to ensure the homogeneity of the data series.