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.