GET/v1/space-weather

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

What it does

The NOAA SWPC OVATION aurora forecast and the planetary Kp index, with a link to the probability grid. A forecast of where the aurora is likely, about 30 to 90 minutes ahead, not an observation. status is ok, unavailable (the forecast is older than an hour: the times and Kp are still reported, aurora is null) or unknown (no data); never an error. No endorsement by or affiliation with NOAA is implied. One Standard unit per request; a browser (maps) key may call it.

Call it

bash

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

Responses

200Aurora forecast and Kp

Field	Type	Required	Description
age_s	integer	no	Seconds since `forecast_time`. `null` when unknown.
attribution	string	yes	The credit, verbatim.
aurora	AuroraGrid	no
endorsement	string	yes	No endorsement by or affiliation with NOAA is implied.
forecast_time	string	no	The time the aurora forecast is for (RFC 3339).
generated_at	string	yes	When this answer was assembled (RFC 3339).
kp	number	no	Planetary Kp index.
kp_time	string	no	When Kp was measured (RFC 3339).
label	string	yes	Forecast, not an observation.
max_probability	number	no	Highest aurora probability in the grid, percent.
observation_time	string	no	The observation time the forecast was made from (RFC 3339).
status	string	yes	`ok`, `unavailable` or `unknown`.
threshold_s	integer	yes	The age after which the forecast is `unavailable`, seconds.

501Space weather not enabled (SN_LIVE_DIR unset). Not billed

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

Also under live

GET /v1/events 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_space_weather