Appearance
Looking for optical data?
Optical data (all-sky imagers, spectrographs) is not supported by the HAPI server. For that data, please use our Python and IDL libraries, our main data distribution API endpoints, or any of the other standard access methods we provide (HTTP archive, FTP, Rsync).
HAPI Server
The Heliophysics Application Programmer's Interface (HAPI) is a community-developed specification that defines a standard RESTful interface for serving time series data. It is widely used across the heliophysics community, and a growing ecosystem of client libraries and analysis tools can talk to any HAPI-compliant server. You can learn more about the specification and ecosystem at hapi-server.org.
We provide a HAPI server at https://api.phys.ucalgary.ca/hapi for accessing various time series datasets we provide, such as the riometer data. This service is maintained in addition to our core API and our tooling, since we limit it to the time series data that HAPI is primarily designed to help facilitate.
Want to have a quick look at some data without writing any code? Open the interactive viewer below to choose a dataset and time range - the data loads directly into your browser and the plot updates automatically as you change your selections. Once the data is loaded, you can change which parameters are shown on the X and Y axes, drag to zoom in, and double-click to reset the view.
Endpoints
The server implements the standard HAPI endpoints. Click on an endpoint to view an example response.
- Information about the server- Server capabilities, such as the available output formats- List of all available datasets/info- Metadata for a given dataset/data- Data for a given dataset and time range
Dataset Catalog
The table below lists all datasets currently available from our HAPI server, retrieved live from the /catalog endpoint. Click on any dataset to view its metadata (time range, cadence, location, parameters, and more), along with an example command for downloading data.
Show:
No items
Loading catalog ...
Downloading Data
Data is retrieved using the /data endpoint, with the dataset, start, and stop query parameters. Data is returned in CSV format by default, with binary and JSON output also available using the format parameter. Note that each dataset has a maximum request duration (shown in its metadata), so larger downloads should be split into multiple requests.
Use the selectors below to choose a dataset, time range, and format of interest. The tabs then show a direct download URL (with copy and download buttons), along with matching Python and curl examples. Note that this page is set up to only let you play around with simple data calls - if longer durations of data are wanted, use the Python hapiclient example as a starting point, or edit the HTTP request manually.
Loading catalog ...
The HAPI project also provides client libraries for other languages (Matlab, IDL, Java, JavaScript), along with analysis and visualization tools that can connect to any HAPI server. See the HAPI project on GitHub for the full list.