NASA

NASA DONKI API

The DONKI API from NASA — 8 operation(s) for donki.

GitHub OpenAPI

Operations 8

GET /DONKI/CME NASA Get coronal mass ejection events #
GET /DONKI/CMEAnalysis NASA Get CME analysis data #
GET /DONKI/GST NASA Get geomagnetic storm events #
GET /DONKI/FLR NASA Get solar flare events #
GET /DONKI/SEP NASA Get solar energetic particle events #
GET /DONKI/MPC NASA Get magnetopause crossing events #
GET /DONKI/IPS NASA Get interplanetary shock events #
GET /DONKI/notifications NASA Get space weather notifications #

Documentation

📖
Documentation
https://api.nasa.gov/#apod
📖
Documentation
https://api.nasa.gov/#MarsPhotos
📖
Documentation
https://api.nasa.gov/#NeoWS
📖
Documentation
https://api.nasa.gov/#DONKI
📖
Documentation
https://api.nasa.gov/#EPIC
📖
Documentation
https://api.nasa.gov/#Images

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/nasa/refs/heads/main/openapi/nasa-donki-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/nasa-donki-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

nasa-donki-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: NASA (Space Weather Database Of Notifications, Knowledge, Information) DONKI API
  description: The DONKI API provides access to space weather events and notifications from NASA's Space Weather Database Of Notifications, Knowledge, Information. It covers coronal mass ejections, geomagnetic storms, solar flares, solar energetic particles, magnetopause crossings, radiation belt enhancements, high-speed streams, and interplanetary shocks.
  version: 1.0.0
  contact:
    name: NASA API Support
    url: https://api.nasa.gov
servers:
- url: https://api.nasa.gov
tags:
- name: DONKI
paths:
  /DONKI/CME:
    get:
      operationId: getCoronalMassEjections
      summary: NASA Get coronal mass ejection events
      description: Returns coronal mass ejection (CME) events within a date range.
      parameters:
      - name: startDate
        in: query
        required: false
        description: Start date (YYYY-MM-DD). Defaults to 30 days prior.
        schema:
          type: string
          format: date
      - name: endDate
        in: query
        required: false
        description: End date (YYYY-MM-DD). Defaults to today.
        schema:
          type: string
          format: date
      - name: api_key
        in: query
        required: true
        schema:
          type: string
          default: DEMO_KEY
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CoronalMassEjection'
      tags:
      - DONKI
  /DONKI/CMEAnalysis:
    get:
      operationId: getCmeAnalysis
      summary: NASA Get CME analysis data
      description: Returns analysis data for coronal mass ejection events.
      parameters:
      - name: startDate
        in: query
        required: false
        schema:
          type: string
          format: date
      - name: endDate
        in: query
        required: false
        schema:
          type: string
          format: date
      - name: mostAccurateOnly
        in: query
        required: false
        schema:
          type: boolean
          default: true
      - name: speed
        in: query
        required: false
        schema:
          type: integer
      - name: halfAngle
        in: query
        required: false
        schema:
          type: integer
      - name: catalog
        in: query
        required: false
        schema:
          type: string
          enum:
          - ALL
          - SWRC_CATALOG
          - JANG_ET_AL_CATALOG
      - name: api_key
        in: query
        required: true
        schema:
          type: string
          default: DEMO_KEY
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CmeAnalysis'
      tags:
      - DONKI
  /DONKI/GST:
    get:
      operationId: getGeomagneticStorms
      summary: NASA Get geomagnetic storm events
      parameters:
      - name: startDate
        in: query
        required: false
        schema:
          type: string
          format: date
      - name: endDate
        in: query
        required: false
        schema:
          type: string
          format: date
      - name: api_key
        in: query
        required: true
        schema:
          type: string
          default: DEMO_KEY
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/GeomagneticStorm'
      tags:
      - DONKI
  /DONKI/FLR:
    get:
      operationId: getSolarFlares
      summary: NASA Get solar flare events
      parameters:
      - name: startDate
        in: query
        required: false
        schema:
          type: string
          format: date
      - name: endDate
        in: query
        required: false
        schema:
          type: string
          format: date
      - name: api_key
        in: query
        required: true
        schema:
          type: string
          default: DEMO_KEY
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SolarFlare'
      tags:
      - DONKI
  /DONKI/SEP:
    get:
      operationId: getSolarEnergeticParticles
      summary: NASA Get solar energetic particle events
      parameters:
      - name: startDate
        in: query
        required: false
        schema:
          type: string
          format: date
      - name: endDate
        in: query
        required: false
        schema:
          type: string
          format: date
      - name: api_key
        in: query
        required: true
        schema:
          type: string
          default: DEMO_KEY
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SolarEnergeticParticle'
      tags:
      - DONKI
  /DONKI/MPC:
    get:
      operationId: getMagnetopauseCrossings
      summary: NASA Get magnetopause crossing events
      parameters:
      - name: startDate
        in: query
        required: false
        schema:
          type: string
          format: date
      - name: endDate
        in: query
        required: false
        schema:
          type: string
          format: date
      - name: api_key
        in: query
        required: true
        schema:
          type: string
          default: DEMO_KEY
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
      tags:
      - DONKI
  /DONKI/IPS:
    get:
      operationId: getInterplanetaryShocks
      summary: NASA Get interplanetary shock events
      parameters:
      - name: startDate
        in: query
        required: false
        schema:
          type: string
          format: date
      - name: endDate
        in: query
        required: false
        schema:
          type: string
          format: date
      - name: location
        in: query
        required: false
        schema:
          type: string
          enum:
          - Earth
          - MESSENGER
          - STEREO A
          - STEREO B
      - name: catalog
        in: query
        required: false
        schema:
          type: string
          enum:
          - ALL
          - SWRC_CATALOG
          - WINSLOW_MESSENGER_ICME_CATALOG
      - name: api_key
        in: query
        required: true
        schema:
          type: string
          default: DEMO_KEY
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
      tags:
      - DONKI
  /DONKI/notifications:
    get:
      operationId: getDonkiNotifications
      summary: NASA Get space weather notifications
      parameters:
      - name: startDate
        in: query
        required: false
        schema:
          type: string
          format: date
      - name: endDate
        in: query
        required: false
        schema:
          type: string
          format: date
      - name: type
        in: query
        required: false
        schema:
          type: string
          enum:
          - all
          - FLR
          - SEP
          - CME
          - IPS
          - MPC
          - GST
          - RBE
          - report
      - name: api_key
        in: query
        required: true
        schema:
          type: string
          default: DEMO_KEY
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Notification'
      tags:
      - DONKI
components:
  schemas:
    SolarFlare:
      type: object
      properties:
        flrID:
          type: string
        instruments:
          type: array
          items:
            type: object
            properties:
              displayName:
                type: string
        beginTime:
          type: string
          format: date-time
        peakTime:
          type: string
          format: date-time
        endTime:
          type: string
          format: date-time
        classType:
          type: string
        sourceLocation:
          type: string
        activeRegionNum:
          type: integer
    GeomagneticStorm:
      type: object
      properties:
        gstID:
          type: string
        startTime:
          type: string
          format: date-time
        allKpIndex:
          type: array
          items:
            type: object
            properties:
              observedTime:
                type: string
                format: date-time
              kpIndex:
                type: number
              source:
                type: string
    CoronalMassEjection:
      type: object
      properties:
        activityID:
          type: string
        catalog:
          type: string
        startTime:
          type: string
          format: date-time
        sourceLocation:
          type: string
        activeRegionNum:
          type: integer
        note:
          type: string
        instruments:
          type: array
          items:
            type: object
            properties:
              displayName:
                type: string
        cmeAnalyses:
          type: array
          items:
            $ref: '#/components/schemas/CmeAnalysis'
    CmeAnalysis:
      type: object
      properties:
        time21_5:
          type: string
          format: date-time
        latitude:
          type: number
        longitude:
          type: number
        halfAngle:
          type: number
        speed:
          type: number
        type:
          type: string
        isMostAccurate:
          type: boolean
    SolarEnergeticParticle:
      type: object
      properties:
        sepID:
          type: string
        eventTime:
          type: string
          format: date-time
        instruments:
          type: array
          items:
            type: object
            properties:
              displayName:
                type: string
    Notification:
      type: object
      properties:
        messageType:
          type: string
        messageID:
          type: string
        messageURL:
          type: string
          format: uri
        messageIssueTime:
          type: string
          format: date-time
        messageBody:
          type: string