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.

Examples of ISGI's web service requests

aa data for the last past 7 days in IAGA2002 format
https://isgi.unistra.fr/ws?user=your_user_name&index=aa
dst data from 2015-08-01 to 2015-08-31 in IAGA2002 format
https://isgi.unistra.fr/ws?user=your_user_name&index=dst&StartTime=2015-08-01&EndTime=2015-08-31
am data from 2022-10-01 to 2022-10-15 in json format
https://isgi.unistra.fr/ws?user=your_user_name&index=am&format=json&StartTime=2022-10-01&EndTime=2022-10-15
Kp data from 2024-06-04 to 2024-06-05 in VOTable format
https://isgi.unistra.fr/ws?user=your_user_name&index=Kp&format=VOTable&StartTime=2024-06-04&EndTime=2024-06-05

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 except for PC, PCN, PCS and AE indices, for which the amount of data requested is limited to one month.
Please note that data downloaded in json or VOTable format is not compressesed and may be quite large.

Parameters

Mandatory parameters

user name	The user name sent to you by ISGI chairman

index	Index or event requested data Valid values: aa, am, Kp, Dst, PC, PCN, PCS, AE, SC, SFE, Qdays, CKdays, (ASY, aσ)

Optional parameters

StartTime	Time of first requested data Default: Current UTC day - 7 days Format: ISO8601 (YYYY-MM-DD) Example: 2017-05-01

EndTime	Time of last requested data Default: Current UTC day Format: ISO8601 (YYYY-MM-DD) Example: 2017-05-09

format	Chosen output format Default: IAGA2002 Valid values: IAGA2002, json, VOTable Limitations: IAGA2002 data format is available for all data products; json & VOTable data format are available for all data products except PC, SC and SFE

Output data

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 for IAGA2002 format
as a single file for json or VOTable format

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.

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.