Health

Endpoints

GET /api/v1/health

Returns database status, pipeline run history, CVE corpus counts, disk usage, and service availability. Used by Uptime Robot and internal monitoring.

curl https://breachspider.com/api/v1/health

Response

{
  "api": {
    "version": "1.0.0",
    "request_id": "bs-req-520be8d7ec44",
    "timestamp": "2026-06-07T13:26:29.000000Z",
    "processing_ms": 1
  },
  "data": {
    "status": "healthy",
    "database": "connected",
    "pipeline": {
      "ingest": {
        "status": "success",
        "last_run": "2026-06-07T04:00:38Z",
        "rows": 1842,
        "hours_since": 9.4,
        "duration_sec": 41.2
      },
      "enricher": {
        "status": "success",
        "last_run": "2026-06-07T05:12:00Z",
        "rows": 1840,
        "hours_since": 8.2,
        "duration_sec": 312.1
      }
    },
    "services": {
      "api": "operational",
      "enricher": "success",
      "renderer": "success",
      "alerts": "success"
    },
    "counts": {
      "total_cves": 354520,
      "alert_ready": 353588,
      "pending_enrichment": 0,
      "rendered": 312400
    },
    "db_size_mb": 4821.3,
    "disk_free_gb": 38.2
  },
  "meta": {
    "uptime_url": "https://status.breachspider.com",
    "version": "1.0.0",
    "environment": "production"
  }
}

Status Values

GET /api/v1/health/ping

Lightweight endpoint for basic liveness checks. Returns 200 with no database queries. Use this for load balancer health checks.

curl https://breachspider.com/api/v1/health/ping

{"ping": "pong"}