Wildfire API — docs

Real-time wildfire detections, fire-danger forecasts and official warnings for Europe. Get a key at /dashboard.

Authenticatie

Elke request heeft een Authorization-header nodig:

Authorization: Bearer wf_<jouw-key>

Rate limits

Eén teller per key, per UTC-kalenderdag. Bij overschrijding: 429 met een Retry-After-header (seconden tot middernacht UTC).

Plan	Requests/dag
free	50
starter	5.000
pro	50.000

Foutcodes

Status	Betekenis
400	Ontbrekende/ongeldige parameters
401	Ontbrekende of onbekende API-key
404	Onbekend fire-event id/slug
429	Daglimiet bereikt voor je plan

`GET /api/v1/risk`

Brandrisico voor één punt: regio, fire-danger (vandaag + forecast), dichtstbijzijnde actieve brand, actieve waarschuwingen, wind/temperatuur.

Param	Type	Verplicht
lat	float	ja
lon	float	ja

Voorbeeld:

curl -H "Authorization: Bearer wf_..." \
  "https://<host>/api/v1/risk?lat=40.5&lon=9.0"

{
  "location": { "lat": 40.5, "lon": 9.0, "countryCode": "IT", "regionId": "nuts_ITG2D" },
  "danger": {
    "today":    { "fwiClass": "extreme", "fwiValue": null },
    "forecast": [{ "date": "2026-08-05", "fwiClass": "high", "fwiValue": null }]
  },
  "nearestFire": {
    "id": "cmsenw...", "name": "Brand bij Bottidda", "slug": "2026-bottidda-...",
    "status": "COOLING", "trend": "STABLE", "severity": 75,
    "distanceKm": 10, "bearingDeg": 176
  },
  "warnings": [
    { "type": "extreme_temp", "level": "RED", "expires": "2026-08-04T17:59:00.000Z",
      "headline": "Red High-temperature Warning issued for Italy - Sardegna", "scope": "country" }
  ],
  "wind": { "temperatureC": 33.8, "windSpeedKmh": 16.7, "windDirectionDeg": 303 },
  "attribution": ["NASA FIRMS", "© European Union, Copernicus/EFFIS", "..."]
}

`GET /api/v1/fires`

GeoJSON FeatureCollection van fire-events, optioneel gefilterd op regio en status.

Param	Type	Verplicht
bbox	west,south,east,north	nee
status	CANDIDATE / ACTIVE / COOLING / CLOSED	nee (standaard: alles behalve CLOSED)

Voorbeeld:

curl -H "Authorization: Bearer wf_..." \
  "https://<host>/api/v1/fires?bbox=-10,36,10,48&status=ACTIVE"

{
  "type": "FeatureCollection",
  "features": [{
    "type": "Feature",
    "geometry": { "type": "Polygon", "coordinates": [[...]] },
    "properties": {
      "id": "cmsenw...", "name": "Brand bij Bottidda", "slug": "2026-bottidda-...",
      "status": "ACTIVE", "severity": 75, "trend": "STABLE",
      "detectionCount": 12, "totalFrp": "340.2", "estAreaHa": 45,
      "countryCode": "IT", "durationH": 30, "lastSeen": "2026-08-04T16:00:00.000Z"
    }
  }],
  "attribution": ["NASA FIRMS", "© European Union, Copernicus/EFFIS", "..."]
}

`GET /api/v1/fires/:id`

Detail van één fire-event (id of slug) inclusief de meest recente 200 detecties.

Voorbeeld:

curl -H "Authorization: Bearer wf_..." \
  "https://<host>/api/v1/fires/2026-bottidda-n1xf0zrc"

{
  "id": "cmsenw...", "name": "Brand bij Bottidda", "slug": "2026-bottidda-...",
  "status": "ACTIVE", "severity": 75, "trend": "STABLE",
  "detectionCount": 12, "totalFrp": 340.2, "maxFrp": 48.1, "estAreaHa": 45,
  "countryCode": "IT", "centroid": { "lat": 40.4, "lon": 9.05 },
  "firstSeen": "2026-08-03T10:00:00.000Z", "lastSeen": "2026-08-04T16:00:00.000Z",
  "detections": [
    { "id": "cm...", "lat": 40.41, "lon": 9.06, "acquiredAt": "2026-08-04T13:51:00.000Z",
      "frp": 48.1, "confidence": "HIGH", "source": "MODIS" }
  ],
  "detectionsTruncated": false,
  "attribution": ["NASA FIRMS", "© European Union, Copernicus/EFFIS", "..."]
}

Attributie

Elke response bevat een attribution-veld — verplicht doorvertalen naar je eigen gebruikers (NASA FIRMS, Copernicus/EFFIS, MeteoAlarm, Eurostat GISCO, Open-Meteo). Dit is geen officieel waarschuwingsplatform: volg altijd lokale autoriteiten.