Documentation
GlobalSystem AI API
All API responses include metadata, request IDs, source attribution, timing, and stable v1 payloads for climate and disaster intelligence workflows.
Base URL
Use the active module domain as base.
https://aifire.ai/api/v1Endpoints
| /api/v1 | Endpoint index |
| /api/v1/status | Platform, cache, uptime, and source health |
| /api/v1/module | Current module based on hostname |
| /api/v1/events | Aggregated event feed with filters |
| /api/v1/trends | Current cache-window trend summary |
| /api/v1/sources | Source metadata, coverage, cache state, and limitations |
| /api/v1/openapi.json | OpenAPI descriptor |
Event filters
Supported query parameters: module, limit, source, severity, category, country, bbox, and sort.
curl "https://aifire.ai/api/v1/events?source=nasa_eonet&severity=warning&sort=severity_desc"
curl "https://aiearthquake.ai/api/v1/events?country=Japan&limit=100"Authentication
Public endpoints remain open unless GLOBALSYSTEM_API_KEY is configured. When configured, send the key via X-API-Key.
Caching and stale data
External responses are cached in /storage/cache. If a live provider call fails and cached data exists, responses can continue with stale state indicated in the payload.