Health Check

`GET /api/v1/health`

Returns the current health status of the registry service and its dependencies.

Headers

This endpoint differs from other API endpoints:

Header	Value
`Cache-Control`	`no-cache, no-store`
`Content-Type`	`application/json`

Status Codes

Status	Meaning
`200`	All checks passing — service is healthy
`503`	One or more checks failing — service is degraded or unhealthy

Response


{
  "status": "healthy",
  "timestamp": "2026-03-14T12:00:00.000Z",
  "version": "4.0.1",
  "checks": {
    "registry": {
      "status": "pass",
      "latencyMs": 2,
      "itemCount": 72
    },
    "filesystem": {
      "status": "pass",
      "latencyMs": 1,
      "message": "ok"
    }
  }
}

Response Fields

Field	Type	Description
`status`	`string`	Overall status: `healthy`, `degraded`, or `unhealthy`
`timestamp`	`string`	ISO 8601 timestamp of the check
`version`	`string`	Application version
`checks`	`object`	Individual dependency checks
`checks.*.status`	`string`	`pass` or `fail`
`checks.*.latencyMs`	`number`	Check latency in milliseconds

Example


curl https://registry.mukoko.com/api/v1/health