---
title: "`GET /v1/space-weather/aurora.png`: the aurora probability grid."
method: GET
path: "/v1/space-weather/aurora.png"
tags: ["live"]
---

# \`GET /v1/space-weather/aurora.png\`: the aurora probability grid.

`GET /v1/space-weather/aurora.png`

## Request

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

The aurora probability grid: a 360 by 181 8-bit grey PNG, one byte per cell holding the probability in percent, column 0 at 180 W, row 0 at 90 N. A forecast, not an observation. Never served stale: a forecast older than an hour, or no file, is `404 aurora-unavailable`. Carries an `ETag`; `If-None-Match` answers 304. One Standard unit per request.

## Response `200`

The grid

## Other responses

- `304`: Not modified (If-None-Match matched the ETag)
- `404`: `aurora-unavailable`: the forecast is older than an hour or missing. Not billed
- `501`: Space weather 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)