GET/v1/events

API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….

What it does

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.

Call it

bash

curl -fsS -X GET "https://api.mapmap.ai/v1/events" \
  -H "Authorization: Bearer $MAPMAP_KEY"

Parameters

Name	In	Required	Description
types	query	no	Comma list of `quake`, `volcano`, `fire`. Default all three. Anything else is `400 invalid-types`
bbox	query	no	`west,south,east,north` in WGS84 degrees, `west < east`, `south < north`. A box across the antimeridian is `400 invalid-bbox`. Default: the whole world
min_magnitude	query	no	Quakes only. 2.5 to 9.0, default 2.5. Otherwise `400 invalid-magnitude`
limit	query	no	Features returned, 1 to 5000, default 2000. Newest quakes first, then volcano alerts, then fire cells by count; `truncated` is true when cut. Otherwise `400 invalid-limit`

Responses

200GeoJSON FeatureCollection with per-feed freshness and the honesty text

Field	Type	Required	Description
acknowledgment	string	yes	The NASA FIRMS acknowledgment, verbatim.
attribution	EventsAttribution	yes	The credit for each feed, verbatim.
count	integer	yes	Features in this answer.
coverage	string	yes	What the feeds cover and what they do not.
disclaimer	string	yes	The NASA "as is" disclaimer, verbatim.
endorsement	string	yes	No endorsement by or affiliation with USGS, NOAA or NASA is implied.
features	EventFeature[]	yes	The events: newest quakes, then volcano alerts by time sent, then fire cells by detection count.
feeds	EventsFeeds	yes	Freshness of each requested feed. Read it before drawing events as current.
generated_at	string	yes	When this answer was assembled (RFC 3339).
label	string	yes	Reported events for display; not a warning service.
truncated	boolean	yes	True when more features matched than `limit`.
type	string	yes	Always `FeatureCollection`.

400invalid-types, invalid-bbox, invalid-magnitude or invalid-limit. Not billed

501Live events not enabled (SN_LIVE_DIR unset). Not billed

Error bodies follow the shared problem model documented on API conventions.

Also under live

GET /v1/space-weather GET /v1/space-weather/aurora.png GET /v1/weather/frames GET /v1/weather/frames/gfs/{run}/{field}/{file}

Generated from https://api.mapmap.ai/openapi.json on 2026-10-17 · operationId get_events