# NASA API: List natural events

> List EONET natural events with latest observations in the past number of days, most recent first. A country or region filter matches reported event locations against mapped boundaries; locations and ongoing status are approximate, and not all events have a reported size or strength.

Unofficial. Not affiliated with or endorsed by NASA.

- Page: https://fous.com/methods/nasa.gov/list-natural-events
- Method: `nasa.gov/list_natural_events`, version 1
- Website: nasa.gov
- Returns: event name, type, latest observation date, ongoing, size or strength, source links, page link, coordinates, EONET id
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `days_back` | integer | no | `30` | Include observations from this many days including today, for example 30. Default 30. |
| `open_only` | boolean | no | `false` | Include only ongoing events, for example true. Default true. |
| `event_type` | string | no | `"severe_storms"` | Event category, for example wildfires. One of "any", "wildfires", "volcanoes", "severe_storms", "sea_and_lake_ice", "floods", "dust_and_haze". Default "any". |
| `max_results` | integer | no | `15` | Maximum number of events to return, for example 50. Default 50. |
| `country_or_region` | string | no |  | Country or region name to restrict results, for example California or Australia. Leave blank for anywhere. Default "". |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "days_back": 30,
  "open_only": false,
  "event_type": "severe_storms",
  "max_results": 15
}
```

Its output:

```json
{
  "events": [
    {
      "ongoing": "yes",
      "latitude": 13.9,
      "longitude": -101.5,
      "page_link": "https://eonet.gsfc.nasa.gov/api/v3/events/EONET_24875",
      "event_name": "Tropical Storm Rachel",
      "event_type": "Severe Storms",
      "source_links": [
        "https://www.metoc.navy.mil/jtwc/products/ep1826.tcw",
        "https://www.nhc.noaa.gov/archive/2026/RACHEL.shtml"
      ],
      "eonet_event_id": "EONET_24875",
      "size_or_strength": "45 kts",
      "latest_observation_date": "2026-09-28"
    },
    {
      "ongoing": "yes",
      "latitude": 17.3,
      "longitude": -162.7,
      "page_link": "https://eonet.gsfc.nasa.gov/api/v3/events/EONET_24786",
      "event_name": "Hurricane Nolo",
      "event_type": "Severe Storms",
      "source_links": [
        "https://www.metoc.navy.mil/jtwc/products/ep1526.tcw"
      ],
      "eonet_event_id": "EONET_24786",
      "size_or_strength": "130 kts",
      "latest_observation_date": "2026-09-28"
    },
    {
      "ongoing": "yes",
      "latitude": 28.1,
      "longitude": 133.2,
      "page_link": "https://eonet.gsfc.nasa.gov/api/v3/events/EONET_24787",
      "event_name": "Super Typhoon Surigae",
      "event_type": "Severe Storms",
      "source_links": [
        "https://www.metoc.navy.mil/jtwc/products/wp2526.tcw"
      ],
      "eonet_event_id": "EONET_24787",
      "size_or_strength": "70 kts",
      "latest_observation_date": "2026-09-28"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"nasa.gov/list_natural_events","input":{"days_back":30,"open_only":false,"event_type":"severe_storms","max_results":15}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What wildfires are currently burning in California? Show me anything observed in the last 10 days.
- Pull NASA's EONET feed for active volcanoes worldwide reported over the past 60 days, up to 25 results.
- Any severe storms tracked near the Philippines in the last two weeks, including ones that have already ended?
- List ongoing floods in Bangladesh from the past month with their coordinates and source links.
- Using nasa.gov event data, give me the 100 most recent natural hazards of any type observed anywhere in the last 7 days.

## Input schema

```json
{
  "type": "object",
  "properties": {
    "days_back": {
      "type": "integer",
      "default": 30,
      "maximum": 365,
      "minimum": 1,
      "description": "Include observations from this many days including today, for example 30."
    },
    "open_only": {
      "type": "boolean",
      "default": true,
      "description": "Include only ongoing events, for example true."
    },
    "event_type": {
      "enum": [
        "any",
        "wildfires",
        "volcanoes",
        "severe_storms",
        "sea_and_lake_ice",
        "floods",
        "dust_and_haze"
      ],
      "type": "string",
      "default": "any",
      "description": "Event category, for example wildfires."
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum number of events to return, for example 50."
    },
    "country_or_region": {
      "type": "string",
      "default": "",
      "description": "Country or region name to restrict results, for example California or Australia. Leave blank for anywhere."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "events"
  ],
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "event_name",
          "event_type",
          "latest_observation_date",
          "ongoing",
          "size_or_strength",
          "source_links",
          "page_link",
          "latitude",
          "longitude",
          "eonet_event_id"
        ],
        "properties": {
          "ongoing": {
            "enum": [
              "yes",
              "no"
            ],
            "type": "string",
            "description": "Whether EONET still considers the event open."
          },
          "latitude": {
            "type": [
              "number",
              "null"
            ],
            "description": "Latest reported latitude."
          },
          "longitude": {
            "type": [
              "number",
              "null"
            ],
            "description": "Latest reported longitude."
          },
          "page_link": {
            "type": "string",
            "description": "Page for this event at EONET."
          },
          "event_name": {
            "type": "string",
            "description": "Natural event name."
          },
          "event_type": {
            "type": "string",
            "description": "EONET event category."
          },
          "source_links": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Links supplied by event sources."
          },
          "eonet_event_id": {
            "type": "string",
            "description": "EONET event identifier."
          },
          "size_or_strength": {
            "type": [
              "string",
              "null"
            ],
            "description": "Latest reported magnitude and unit, when available."
          },
          "latest_observation_date": {
            "type": "string",
            "format": "date",
            "description": "Date of the latest reported observation."
          }
        },
        "additionalProperties": false
      },
      "description": "Matching natural events, most recent observation first."
    }
  },
  "additionalProperties": false
}
```

## See more

- [NASA API: List near-Earth asteroids](https://fous.com/methods/nasa.gov/list-near-earth-asteroids.md): Lists near-Earth asteroids that pass Earth between two UTC dates within a chosen distance, with approach times, size ranges, speed and hazard status.
- [NASA API: Get ISS sightings](https://fous.com/methods/nasa.gov/get-iss-sightings.md): Finds upcoming International Space Station sightings for a city in NASA's city list, with local start times, visibility and sky directions. Cities without scheduled passes return an empty list.
- [NASA API: Get astronomy picture of the day](https://fous.com/methods/nasa.gov/get-astronomy-picture-of-the-day.md): Returns NASA's Astronomy Picture of the Day for a date: title, explanation, featured media link, optional high-resolution link, and credit.
- [NASA API: Search media](https://fous.com/methods/nasa.gov/search-images.md): Searches NASA public photos, videos or audio by words and creation year, returning matches in relevance order with thumbnails and full-size file links.
- [NOAA API: List space weather alerts](https://fous.com/methods/swpc.noaa.gov/list-space-weather-alerts.md): Lists NOAA space weather alerts, warnings, watches and summaries issued in the last 1 to 7 days, newest first, with validity times and NOAA scale levels when the message gives them.
- [USGS API: List significant earthquakes](https://fous.com/methods/earthquake.usgs.gov/list-significant-earthquakes.md): Lists significant worldwide earthquakes for the past day, week, or month, newest first, with USGS PAGER alert levels and impact summaries when USGS provides them.
- [Wildfire.gov API: List active wildfires](https://fous.com/methods/inciweb.wildfire.gov/list-active-wildfires.md): Lists active InciWeb fire incidents in a US state, newest table updates first, with size, containment, location, cause, dates and any evacuation or closure note. Prescribed fires and other fire-related incidents can appear.
- [USGS API: Search earthquakes near a place](https://fous.com/methods/earthquake.usgs.gov/search-earthquakes.md): Finds recent USGS earthquakes near a city, address, or region, with distances and times in the searched place's time zone.
- [All NASA methods](https://fous.com/methods/nasa.gov.md)