# greeneris-data-geo-disasters

> greeneris-data-geo-disasters is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Retrieve current and recent global disaster events (earthquakes, cyclones, floods, volcanoes, wildfires, droughts) filtered by bounding box, type, and severity level, sourced from GDACS.

## Facts

- Endpoint: GET https://data.greeneris.io/v1/geo/disasters
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/greeneris-data-geo-disasters-6204574a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SQSlGIgY62yUu1SqdKcm1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability greeneris-data-geo-disasters-6204574a
```

Example prompt: What natural disasters are currently active in Japan? Show me any tropical cyclones or earthquakes at orange or red alert level.

## When to prefer this

Use this endpoint when you need real-time global disaster situational awareness filtered by geography, disaster type, or severity. Ideal for humanitarian response workflows, supply chain risk monitoring, travel safety checks, or any agent needing structured GDACS data without scraping. Prefer over manual GDACS web lookups when machine-readable structured output and geographic filtering are needed.

## Known failure modes

- Invalid bbox format (not min_lon,min_lat,max_lon,max_lat) returns 400
- Invalid event type enum value returns 400
- Invalid alert level enum value returns 400
- No matching events returns count:0 with empty events array
- HTTP 402 returned if payment not provided — must pay $0.005 USDC via x402 protocol on Base before retrying
- Service unavailable if GDACS upstream is down

## How this service works

All currently active disaster events monitored by GDACS (European Commission JRC / UN OCHA, attribution CC-BY-style), normalized and sorted by alert score. Optional filters: ?type=TC|EQ|FL|VO|WF|DR, level=green|orange|red, bbox=min_lon,min_lat,max_lon,max_lat. Each event: type, name, Green/Orange/Red level, countries, dates, coordinates, report URL. 15 min cache.

## Output

A JSON object containing a count of matching events and an array of disaster event objects, each with event ID, name, country, ISO3 code, coordinates, date range, event type code, current status flag, alert level (green/orange/red), numeric alert score, severity description text, and a link to the full GDACS report. Also includes source attribution and applied filters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "bbox": {
       "type": "string",
       "description": "Geographic filter 'min_lon,min_lat,max_lon,max_lat'"
      },
      "type": {
       "enum": [
        "EQ",
        "TC",
        "FL",
        "VO",
        "WF",
        "DR"
       ],
       "type": "string",
       "description": "Event type (earthquake, cyclone, flood, volcano, wildfire, drought)"
      },
      "level": {
       "enum": [
        "green",
        "orange",
        "red"
       ],
       "type": "string",
       "description": "Minimum-severity color filter (exact match)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "events": [
   {
    "iso3": "JPN",
    "name": "Tropical Cyclone NARI-26",
    "country": "Japan",
    "to_date": "2026-07-14T06:00:00",
    "event_id": 1001156,
    "latitude": 40.6,
    "from_date": "2026-07-10T00:00:00",
    "longitude": 141.9,
    "event_type": "TC",
    "is_current": true,
    "report_url": "https://www.gdacs.org/report.aspx?eventid=1001156&episodeid=32&eventtype=TC",
    "alert_level": "Orange",
    "alert_score": 2,
    "severity_text": "Tropical Storm (maximum wind speed 120 km/h)"
   }
  ],
  "source": "GDACS - Global Disaster Alert and Coordination System (EC JRC / UN OCHA), CC-BY 4.0",
  "filters": {
   "type": "TC"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/greeneris-data-geo-disasters-6204574a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)