NASA EONET (Earth Observatory Natural Event Tracker)

Continuously updated, curated source of natural events occurring on Earth — wildfires, severe storms, volcanoes, sea/lake ice, drought, dust/haze, earthquakes, floods, landslides, manmade events, snow, temperature extremes, and water color. Returns events, categories, layers, sources, and magnitudes.

NASA EONET (Earth Observatory Natural Event Tracker) is one of 17 APIs that NASA Open APIs publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 machine-runnable capability that can be deployed as REST, MCP, or Agent Skill surfaces via Naftiko.

Tagged areas include Earth, Natural Events, Disasters, Earth Observatory, and NASA. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, and 1 Naftiko capability spec.

OpenAPI Specification

eonet-openapi.yml Raw ↑
openapi: 3.0.3
info:
  title: NASA EONET (Earth Observatory Natural Event Tracker)
  description: |
    Curated source of natural events occurring on Earth - wildfires, severe storms, volcanoes, sea/lake ice,
    drought, dust/haze, earthquakes, floods, landslides, manmade, snow, temperature extremes, and water color.
  version: '3.0'
  contact:
    name: NASA Earth Observatory
    url: https://eonet.gsfc.nasa.gov/docs/v3
  license:
    name: US Government Work (Public Domain)
servers:
- url: https://eonet.gsfc.nasa.gov/api/v3
paths:
  /events:
    get:
      summary: Get Natural Events
      operationId: getEvents
      tags:
      - Events
      parameters:
      - name: source
        in: query
        description: Filter by source ID (comma-separated for multiple).
        schema:
          type: string
      - name: status
        in: query
        schema:
          type: string
          enum:
          - open
          - closed
          - all
      - name: limit
        in: query
        schema:
          type: integer
      - name: days
        in: query
        description: Limit to events within the last N days.
        schema:
          type: integer
      - name: start
        in: query
        schema:
          type: string
          format: date
      - name: end
        in: query
        schema:
          type: string
          format: date
      - name: magID
        in: query
        schema:
          type: string
      - name: magMin
        in: query
        schema:
          type: number
      - name: magMax
        in: query
        schema:
          type: number
      - name: bbox
        in: query
        description: Bounding box minlon,maxlat,maxlon,minlat.
        schema:
          type: string
      - name: category
        in: query
        schema:
          type: string
      responses:
        '200':
          description: Collection of natural events.
          content:
            application/json:
              schema:
                type: object
                properties:
                  title:
                    type: string
                  description:
                    type: string
                  link:
                    type: string
                  events:
                    type: array
                    items:
                      type: object
  /categories:
    get:
      summary: Get Event Categories
      operationId: getCategories
      tags:
      - Categories
      responses:
        '200':
          description: List of EONET event categories.
  /categories/{category}:
    get:
      summary: Get Events for a Category
      operationId: getEventsByCategory
      tags:
      - Categories
      parameters:
      - name: category
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Events in the specified category.
  /sources:
    get:
      summary: Get Event Sources
      operationId: getSources
      tags:
      - Sources
      responses:
        '200':
          description: List of EONET event data sources.
  /layers:
    get:
      summary: Get Layers
      operationId: getLayers
      tags:
      - Layers
      responses:
        '200':
          description: List of map layers associated with EONET categories.
  /magnitudes:
    get:
      summary: Get Magnitude Definitions
      operationId: getMagnitudes
      tags:
      - Magnitudes
      responses:
        '200':
          description: Magnitude IDs and units defined by EONET.