Clarix
API Reference

Health API

System health check endpoint

Health API

Health Check

GET /api/health

Returns the operational status of all platform services.

Response:

{
  "status": "healthy",
  "timestamp": "2026-01-01T00:00:00.000Z",
  "services": {
    "database": "connected",
    "auth": "operational"
  },
  "version": "0.0.3"
}

Status Values

StatusDescription
healthyAll services operational
degradedSome non-critical services unavailable
unhealthyCritical services down

Service Checks

ServiceCheck
databasePostgreSQL connection test
authBetter Auth session validation

Usage

The health endpoint is unauthenticated and designed for:

  • Load balancer health checks
  • Uptime monitoring services
  • CI/CD deployment verification
  • Infrastructure alerting

On this page