Custom Connector
NASA DONKI Connector
Global
The NASA DONKI Connector provides a RESTful interface to access real-time and historical space-weather event data from the NASA DONKI (Database of Notifications, Knowledge, Information) system — including Coronal Mass Ejections, Solar Flares, Geomagnetic Storms, and more. It enables scientific, educational, and operational applications that rely on accurate solar activity tracking and forecasting.
Overview
Integration Overview
The NASA DONKI Connector provides the following integration points:
- getCME. Get Coronal Mass Ejection (CME) events.
- getCMEAnalysis. Get CME kinematics and propagation analysis data.
- getSEP. Get Solar Energetic Particle (SEP) events.
- getFLR. Get Solar Flare events.
- getGST. Get Geomagnetic Storm (GST) events.
- getIPS. Get Interplanetary Shock (IPS) events.
- getMPC. Get Magnetopause Crossing (MPC) events.
- getRBE. Get Radiation Belt Enhancement (RBE) events.
- getHSS. Get High-Speed Stream (HSS) events.
- getNotifications. List DONKI-generated event alerts and forecasts.
Documentation
Detailed Integration Documentation
Get Coronal Mass Ejections (CME)
| Operation ID | getCME |
|---|---|
| Endpoint | /DONKI/CME |
| Purpose | Retrieves CME events within a given date range. |
| Parameters | startDate, endDate, api_key. |
| Output | JSON array of CME event objects with timing, instruments, and catalog info. |
Get CME Analysis
| Operation ID | getCMEAnalysis |
|---|---|
| Endpoint | /DONKI/CMEAnalysis |
| Purpose | Returns CME kinematics and propagation analysis details. |
| Parameters | startDate, endDate, api_key. |
| Output | CME analysis models, speeds, half-angle, and estimated arrival. |
Get Solar Energetic Particles (SEP)
| Operation ID | getSEP |
|---|---|
| Endpoint | /DONKI/SEP |
| Purpose | Provides SEP events and metadata for given dates. |
| Parameters | startDate, endDate, api_key. |
| Output | SEP onset, peak, and integrated flux levels. |
Get Solar Flares (FLR)
| Operation ID | getFLR |
|---|---|
| Endpoint | /DONKI/FLR |
| Purpose | Retrieves solar flare activity with class, timing, and source info. |
| Parameters | startDate, endDate, api_key. |
| Output | JSON with X-ray flare details. |
Get Geomagnetic Storms (GST)
| Operation ID | getGST |
|---|---|
| Endpoint | /DONKI/GST |
| Purpose | Returns geomagnetic storm event metadata. |
| Parameters | startDate, endDate, api_key. |
| Output | Kp index levels, activity strength, and location. |
Get Interplanetary Shocks (IPS)
| Operation ID | getIPS |
|---|---|
| Endpoint | /DONKI/IPS |
| Purpose | Retrieves shockwave events in interplanetary space. |
| Parameters | startDate, endDate, api_key. |
| Output | Impact time, instruments, and velocity. |
Get Magnetopause Crossings (MPC)
| Operation ID | getMPC |
|---|---|
| Endpoint | /DONKI/MPC |
| Purpose | Retrieves magnetosphere boundary crossings. |
| Parameters | startDate, endDate, api_key. |
| Output | Magnetopause crossing event metadata. |
Get Radiation Belt Enhancements (RBE)
| Operation ID | getRBE |
|---|---|
| Endpoint | /DONKI/RBE |
| Purpose | Returns events of increased radiation belt activity. |
| Parameters | startDate, endDate, api_key. |
| Output | Radiation belt enhancement event metadata. |
Get High-Speed Streams (HSS)
| Operation ID | getHSS |
|---|---|
| Endpoint | /DONKI/HSS |
| Purpose | Retrieves solar wind streams impacting Earth. |
| Parameters | startDate, endDate, api_key. |
| Output | High-speed stream event metadata. |
Get Notifications
| Operation ID | getNotifications |
|---|---|
| Endpoint | /DONKI/notifications |
| Purpose | Lists DONKI-generated event alerts and forecasts. |
| Parameters | startDate, endDate, type (optional, e.g. “FLR”, “CME”), api_key. |
| Output | Message type, content, event ID, and related links. |
Example Workflow: Space Weather Monitoring Dashboard
| Monitor real-time events | Use getFLR, getCME, getGST to fetch live updates. |
|---|---|
| Analyze CME trajectories | Use getCMEAnalysis to plot models. |
| Trigger warnings | Use getNotifications for public alerts. |
| Historic comparison | Use startDate and endDate filters on all endpoints. |
Support
For technical support, contact custom-connectors-support@isolutions.sa.