---
title: "Detailed health check"
method: GET
path: "/health/detailed"
tags: ["Health"]
---

# Detailed health check

`GET /health/detailed`

## Request

- Base URL: `https://xga-auction-system.workers.dev`
- URL: `https://xga-auction-system.workers.dev/health/detailed`
- Auth: none declared
- TypeScript: <https://skmtc.dev/manifoldfinance/apis/xga-auction-system-api/docs/health/detailed/get.ts> (a function with typed inputs; its response is checked against the schema)

Perform a comprehensive health check of all system components including database, KV store, Durable Objects, and performance metrics.

## Response `200`

Detailed health check result

- object
  - `success` true, required
  - `timestamp` number, required: Health check timestamp
  - `status` 'healthy' | 'degraded' | 'unhealthy', required: Overall system health
  - `uptime` number, required: System uptime in milliseconds
  - `version` string, required: Application version
  - `environment` string, required: Environment name
  - `components` object, required
    - `database` object, required: Database health
      - `status` 'healthy' | 'degraded' | 'unhealthy', required
      - `lastCheck` number, required: Last health check timestamp
      - `responseTime` number, required: Response time in milliseconds
      - `details` object: Additional health details
    - `kvStore` object, required: KV Store health
      - `status` 'healthy' | 'degraded' | 'unhealthy', required
      - `lastCheck` number, required: Last health check timestamp
      - `responseTime` number, required: Response time in milliseconds
      - `details` object: Additional health details
    - `durableObjects` object, required: Durable Objects health
      - `status` 'healthy' | 'degraded' | 'unhealthy', required
      - `lastCheck` number, required: Last health check timestamp
      - `responseTime` number, required: Response time in milliseconds
      - `details` object: Additional health details
    - `analytics` object, required: Analytics Engine health
      - `status` 'healthy' | 'degraded' | 'unhealthy', required
      - `lastCheck` number, required: Last health check timestamp
      - `responseTime` number, required: Response time in milliseconds
      - `details` object: Additional health details
    - `rateLimiter` object, required: Rate Limiter health
      - `status` 'healthy' | 'degraded' | 'unhealthy', required
      - `lastCheck` number, required: Last health check timestamp
      - `responseTime` number, required: Response time in milliseconds
      - `details` object: Additional health details
    - `scheduler` object, required: Auction Scheduler health
      - `status` 'healthy' | 'degraded' | 'unhealthy', required
      - `lastCheck` number, required: Last health check timestamp
      - `responseTime` number, required: Response time in milliseconds
      - `details` object: Additional health details
    - `cache` object, required: Cache system health
      - `status` 'healthy' | 'degraded' | 'unhealthy', required
      - `lastCheck` number, required: Last health check timestamp
      - `responseTime` number, required: Response time in milliseconds
      - `details` object: Additional health details
    - `externalServices` object, required: External services health
      - `status` 'healthy' | 'degraded' | 'unhealthy', required
      - `lastCheck` number, required: Last health check timestamp
      - `responseTime` number, required: Response time in milliseconds
      - `details` object: Additional health details
  - `performance` object, required
    - `cpuUsage` number, required: CPU usage percentage
    - `memoryUsage` number, required: Memory usage percentage
    - `requestsPerSecond` number, required: Current requests per second
    - `averageResponseTime` number, required: Average response time in milliseconds
    - `activeConnections` integer, required: Active connections count
    - `queuedJobs` integer, required: Queued background jobs
  - `statistics` object, required
    - `totalRequests` integer, required: Total requests processed
    - `totalErrors` integer, required: Total errors encountered
    - `totalAuctions` integer, required: Total auctions created
    - `totalBids` integer, required: Total bids placed
    - `totalUsers` integer, required: Total registered users
    - `totalOrganizations` integer, required: Total organizations
    - `activeApiKeys` integer, required: Active API keys
  - `message` string, required: Detailed health status message

## Other responses

- `400`: Bad Request - Invalid input parameters
- `404`: Not Found - Resource not found
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error
- `503`: Service unavailable - unhealthy

---

[API](https://skmtc.dev/manifoldfinance/apis/xga-auction-system-api.md) - [All operations](https://skmtc.dev/manifoldfinance/apis/xga-auction-system-api/llms.txt) - [OpenAPI document](https://skmtc.dev/manifoldfinance/apis/xga-auction-system-api/revisions/329190dccb50?raw)