# Natural Events API
> Live natural events happening around the world as an API, from NASA EONET (Earth Observatory Natural Event Tracker). List currently active (or past) events — wildfires, severe storms and tropical cyclones, volcanoes, floods, landslides, droughts, sea/lake ice and more — each with its title, category, current location and date, the full track of geometry points over time, and source links; or find the events nearest any coordinate (great-circle distance). Filter by category or time window. Ideal for natural-hazard dashboards, situational awareness, travel-safety, insurance and environmental monitoring.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/naturalevents-api/..."
```

## Pricing
- **Free** (Free) — 3,000 calls/Mo, 2 req/s
- **Starter** ($7/Mo) — 42,000 calls/Mo, 8 req/s
- **Pro** ($19/Mo) — 230,000 calls/Mo, 20 req/s
- **Mega** ($48/Mo) — 1,150,000 calls/Mo, 50 req/s

## Endpoints

### Natural Events

#### `GET /v1/categories` — Event categories

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/naturalevents-api/v1/categories"
```

**Response:**
```json
{
    "data": {
        "count": 13,
        "categories": [
            {
                "id": "drought",
                "title": "Drought",
                "description": "Long lasting absence of precipitation affecting agriculture and livestock, and the overall availability of food and water."
            },
            {
                "id": "dustHaze",
                "title": "Dust and Haze",
                "description": "Related to dust storms, air pollution and other non-volcanic aerosols. Volcano-related plumes shall be included with the originating eruption event."
            },
            {
                "id": "earthquakes",
                "title": "Earthquakes",
                "description": "Related to all manner of shaking and displacement. Certain aftermath of earthquakes may also be found under landslides and floods."
            },
            {
                "id": "floods",
                "title": "Floods",
                "description": "Related to aspects of actual flooding--e.g., inundation, water extending beyond river and lake extents."
            },
            {
                "id": "landslides",
                "title": "Landslides",
                "description": "Related to landslides and variations thereof: mudslides, avalanche."
            },
            {
                "id": "manmade",
                "title": "Manmade",
                "description": "Events that have been human-induced and are extreme in their extent."
     
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/events` — Active (or past) natural events

**Parameters:**
- `status` (query, optional, string) — open | closed | all (default open) Example: `open`
- `category` (query, optional, string) — e.g. wildfires, severeStorms, volcanoes, floods
- `days` (query, optional, string) — Only events from the last N days
- `limit` (query, optional, string) — Max events (1-100, default 30) Example: `30`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/naturalevents-api/v1/events?status=open&limit=30"
```

**Response:**
```json
{
    "data": {
        "count": 30,
        "events": [
            {
                "id": "EONET_20279",
                "link": "https://eonet.gsfc.nasa.gov/api/v3/events/EONET_20279",
                "title": "Typhoon Jangmi",
                "latest": {
                    "date": "2026-05-31T00:00:00Z",
                    "latitude": 20.9,
                    "longitude": 128.1,
                    "magnitude": 70,
                    "magnitude_unit": "kts"
                },
                "status": "open",
                "sources": [
                    {
                        "id": "JTWC",
                        "url": "https://www.metoc.navy.mil/jtwc/products/wp0626.tcw"
                    }
                ],
                "categories": [
                    "Severe Storms"
                ],
                "closed_date": null,
                "data_points": 12
            },
            {
                "id": "EONET_20254",
                "link": "https://eonet.gsfc.nasa.gov/api/v3/events/EONET_20254",
                "title": "Black Ridge Wildfire, Lincoln, Idaho",
                "latest": {
                    "date": "2026-05-25T20:50:00Z",
                    "latitude": 43.050333,
                    "longitude": -113.935667,
                    "magnitude": 1500,
                    "magnitude_unit": "acres"
                },
                "status": "open",
                "sources": [
                    {
                        "id": "IR
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/nearby` — Open events near a coordinate

**Parameters:**
- `lat` (query, optional, string) — Latitude (-90..90) Example: `34`
- `lon` (query, optional, string) — Longitude (-180..180) Example: `-118`
- `radius_km` (query, optional, string) — Search radius in km (1-20000, default 2000)
- `category` (query, optional, string) — Optional category filter
- `limit` (query, optional, string) — Max results (1-100, default 20)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/naturalevents-api/v1/nearby?lat=34&lon=-118"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "total": 129,
        "center": {
            "lat": 34,
            "lon": -118
        },
        "events": [
            {
                "id": "EONET_20233",
                "link": "https://eonet.gsfc.nasa.gov/api/v3/events/EONET_20233",
                "title": "BAIN Wildfire, Riverside, California",
                "latest": {
                    "date": "2026-05-19T15:16:00Z",
                    "latitude": 33.975363,
                    "longitude": -117.505889,
                    "magnitude": 1379,
                    "magnitude_unit": "acres"
                },
                "status": "open",
                "sources": [
                    {
                        "id": "IRWIN",
                        "url": "https://irwin.doi.gov/observer/incidents/a7c6f956-f17f-4a90-9fe7-011addde290c"
                    }
                ],
                "categories": [
                    "Wildfires"
                ],
                "closed_date": null,
                "data_points": 1,
                "distance_km": 46
            },
            {
                "id": "EONET_20157",
                "link": "https://eonet.gsfc.nasa.gov/api/v3/events/EONET_20157",
                "title": "SANDY Wildfire, Ventura, California",
                "latest": {
                    "date": "2026-05-18T13:21:00Z",
                    "latitude": 34.250088,
                    "longitude": -118.743684,
                    "magnitud
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Source & categories

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/naturalevents-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Live, curated natural events (wildfires, severe storms, volcanoes, floods, …). status=open is currently active; events carry a track of geometry points over time.",
        "source": "NASA EONET (Earth Observatory Natural Event Tracker)",
        "endpoints": [
            "/v1/events",
            "/v1/nearby",
            "/v1/categories",
            "/v1/meta"
        ],
        "categories": [
            "drought",
            "dustHaze",
            "earthquakes",
            "floods",
            "landslides",
            "manmade",
            "seaLakeIce",
            "severeStorms",
            "snow",
            "tempExtremes",
            "volcanoes",
            "waterColor",
            "wildfires"
        ]
    },
    "meta": {
        "timestamp": "2026-05-31T07:00:18.610Z",
        "request_id": "2b652a2b-0de6-4170-b019-b10777971a47"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/naturalevents-api
OpenAPI spec: https://www.oanor.com/api/naturalevents-api/openapi.json