GET /api/health

Returns the health status of the API and its database connection. Does not require authentication.

Request

GET /api/health

No parameters required.

Response — healthy

HTTP 200

{
  "status": "ok",
  "db": "ok",
  "latency": "4ms",
  "ts": "2025-03-15T07:30:00.123Z"
}

Field	Type	Description
status	string	"ok"
db	string	"ok"
latency	string	Database round-trip latency (e.g. "4ms")
ts	string	Server time at response

Response — degraded

HTTP 503

{
  "status": "degraded",
  "db": "error",
  "error": "connection refused",
  "latency": "12ms",
  "ts": "2025-03-15T07:30:00.123Z"
}

A 503 response means the database is unreachable. The API is online but cannot serve data requests.

Usage

Use this endpoint to:

• Check uptime from an external monitor
• Validate that your deployment is correctly configured
• Verify connectivity before running a backfill

curl https://mydatafor.life/api/health