Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.climatifai.com/llms.txt

Use this file to discover all available pages before exploring further.

The fire risk endpoint aggregates NASA FIRMS hotspot data from the last five days within a configurable radius around a coordinate and distills it into a single 0–100 risk score. The score is then mapped to a human-readable label — Alto, Medio, or Bajo — so you can quickly triage field locations without parsing raw hotspot arrays. Use this endpoint when you need a single signal to drive alerting logic or to populate a risk dashboard.

​
Endpoint

GET api.climatifai.com/fires/risk

​
Parameters

​
lat
float
required
Center latitude of the location to assess in decimal degrees, WGS 84.
​
lon
float
required
Center longitude of the location to assess in decimal degrees, WGS 84.
​
radius_km
float
default:"100"
Search radius around the center point in kilometres. All hotspots detected within this radius are included in the risk calculation.

​
Response

​
lat
float
required
Center latitude echoed from the request.
​
lon
float
required
Center longitude echoed from the request.
​
radius_km
float
required
Search radius echoed from the request.
​
risk_score
float
required
Aggregated fire risk score on a 0–100 scale. Higher values indicate greater fire activity within the search radius. Computed from the number and intensity of active hotspots detected by VIIRS_SNPP_NRT over the last five days.
​
risk_label
string
required
Human-readable risk tier derived from risk_score:
  • "Alto" — score ≥ 60
  • "Medio" — score 30–59
  • "Bajo" — score < 30
​
hotspot_count
integer
required
Number of active fire hotspots detected within the search radius over the last five days.
​
_cache
object
Cache metadata for the underlying NASA FIRMS data.

​
Error codes

CodeDescription
502Upstream error from NASA FIRMS. The detail field contains the original error message.

​
Example

curl "https://api.climatifai.com/fires/risk?lat=19.4326&lon=-99.1332&radius_km=150"

{
  "lat": 19.4326,
  "lon": -99.1332,
  "radius_km": 150,
  "risk_score": 42.7,
  "risk_label": "Medio",
  "hotspot_count": 5,
  "_cache": {
    "fresh": true,
    "cached_at": "2026-05-18T11:30:00Z",
    "stale": false
  }
}