Skip to main content
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

status
string
required
Always "ok" while the server is running.
last_updated
string
ISO 8601 UTC timestamp of the last completed fast-tier data update.
sources
object
required
Current record counts for each data source.
freshness
object
required
ISO 8601 timestamp per data source indicating when it was last successfully fetched. Keys match source names (e.g. "flights", "ships", "news").
uptime_seconds
number
required
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
}

Build docs developers (and LLMs) love