---
title: "`GET /v1/events`: earthquakes, US volcano alerts and satellite fire cells as GeoJSON, with each feed's freshness."
method: GET
path: "/v1/events"
tags: ["live"]
---

# \`GET /v1/events\`: earthquakes, US volcano alerts and satellite fire cells as GeoJSON, with each feed's freshness.

`GET /v1/events`

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/v1/events`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_key`

Reported Earth events for display as one GeoJSON FeatureCollection: earthquakes (USGS, magnitude 2.5 and above, past 24 hours), elevated volcano alerts (USGS Hazard Notification System; US-monitored volcanoes only) and satellite-detected fire-heat cells (NASA FIRMS VIIRS, 0.5 degree cells; not confirmed fires). Every feature carries `kind`. Each requested feed reports its own freshness (`ok`, `stale` or `unknown`); a stale feed still returns its features. Reported events for display, not a warning service and not safety-critical. One Standard unit per request; a browser (`maps`) key may call it.

## Query parameters

- `types` string
- `bbox` string
- `min_magnitude` number, double
- `limit` integer

## Response `200`

GeoJSON FeatureCollection with per-feed freshness and the honesty text

## Other responses

- `400`: `invalid-types`, `invalid-bbox`, `invalid-magnitude` or `invalid-limit`. Not billed
- `501`: Live events not enabled (`SN_LIVE_DIR` unset). Not billed

---

[API](https://skmtc.dev/mapmap/apis/sn-gateway.md) · [All operations](https://skmtc.dev/mapmap/apis/sn-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/mapmap/apis/sn-gateway/revisions/2293be8b4c38?raw)