GET /api/health
Returns a snapshot of system health including live record counts for each data source, per-source freshness timestamps, and total server uptime. Useful for monitoring dashboards and liveness probes.
Rate limit: 30 requests per minute per IP.
Response
Always "ok" while the server is running.
ISO 8601 UTC timestamp of the last completed fast-tier data update.
Current record counts for each data source. Number of commercial flights currently tracked.
Number of military aircraft.
Number of AIS vessel positions.
Number of satellite positions computed.
Number of recent earthquake events.
Number of live CCTV camera positions.
Number of news items in the current cluster.
Number of detected UAV positions.
Number of active fire detections from FIRMS.
Number of LiveUAMap conflict events.
Number of GDELT geopolitical features.
ISO 8601 timestamp per data source indicating when it was last successfully fetched. Keys match source names (e.g. "flights", "ships", "news").
Total seconds the server process has been running since last start.
Example
curl http://localhost:8000/api/health
{
"status" : "ok" ,
"last_updated" : "2024-01-15T12:00:05" ,
"sources" : {
"flights" : 3241 ,
"military" : 87 ,
"ships" : 12450 ,
"satellites" : 1823 ,
"earthquakes" : 142 ,
"cctv" : 956 ,
"news" : 48 ,
"uavs" : 3 ,
"firms_fires" : 720 ,
"liveuamap" : 15 ,
"gdelt" : 300
},
"freshness" : {
"flights" : "2024-01-15T12:00:00" ,
"ships" : "2024-01-15T12:00:01" ,
"satellites" : "2024-01-15T12:00:02" ,
"news" : "2024-01-15T11:55:10" ,
"earthquakes" : "2024-01-15T11:55:11"
},
"uptime_seconds" : 86412
}