GET /health

Check whether the API and its database are reachable. Use this for uptime monitoring or deployment readiness checks.

Request

GET /v1/health

No parameters, headers, or body required.

Response

200 OK — healthy

{
  "status": "healthy"
}

500 Internal Server Error — database unreachable

{
  "detail": "Database unreachable"
}

This response means the API process is running but cannot connect to PostgreSQL. Typically caused by a misconfigured DATABASE_URL or a stopped database service.

Example

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

Usage notes

• Suitable as a liveness probe in Kubernetes or a Docker health check
• Suitable as an uptime monitor in tools like UptimeRobot or Better Uptime
• Not suitable as a deep application health check — it only verifies database connectivity, not data integrity or ingestion pipeline health