# Health API

The Health API provides endpoints for monitoring application health and readiness, designed for use in container orchestration systems like Kubernetes or Docker.

## Base URL


```
https://api.aitronos.com/v1/health
```

## Available Endpoints

- **[Liveness Check](/docs/api-reference/health/liveness)** - Simple health probe for application availability
- **[Readiness Check](/docs/api-reference/health/readiness)** - Detailed health check with dependency verification


## Use Cases

- **Container Orchestration** - Kubernetes liveness and readiness probes
- **Load Balancers** - Health checks for traffic routing
- **Monitoring Systems** - Application availability monitoring
- **CI/CD Pipelines** - Pre-deployment health validation


## Health Status Values

The API uses a three-tier status system:

- **`healthy`** - All components are operational
- **`degraded`** - Some components are experiencing issues but the service is still functional
- **`unhealthy`** - Critical components are down or the service is not operational


## Monitored Components

The readiness check monitors these critical dependencies:

- **Database** - PostgreSQL connectivity
- **Redis** - Cache connectivity
- **Limit Enforcement** - Rate limiting system status
- **Qdrant** - Vector store connectivity


## Security

Health endpoints are public and do not require authentication. They provide operational information only - no sensitive data is exposed.