---
operation_id: health_check
method: GET
path: /healthz
summary: Liveness-Check (Caddy + docker-compose)
tags: [ops]
stability: stable
since_version: 0.1.0
auth: none
data_product: platform
snapshot_aware: false
attribution_block: false
rate_limit_tier: public
---
# `GET /healthz` — Liveness-Check

Antwortet `200 OK` mit `{"status": "ok", "service": "lodapi-api"}` solange der API-Container läuft. Wird vom Caddy-Reverse-Proxy + Docker-Compose-Healthcheck konsumiert.

## Wann verwenden

- Monitoring-Pings (Prometheus-Blackbox, Uptime-Robot, …).
- Caddy / Load-Balancer Health-Probes.
- Sanity-Test nach jedem Deploy.

## Example

```bash
curl -s https://api.lodapi.de/healthz | jq
# {"status": "ok", "service": "lodapi-api"}
```

## Parameters

Keine.

## Response

`200 OK · application/json`:

```json
{
  "status": "ok",
  "service": "lodapi-api"
}
```

## Stolperdrähte

- **Kein DB-Check** in dieser Antwort. Postgres kann down sein und `/healthz` antwortet trotzdem 200. Für DB-Liveness eigene Probe gegen `/v1/datasets` schicken.
- **Phase 2** wird einen tieferen `/readyz` ergänzen, der DB-Connection-Pool + Auth-Provider prüft.

## Verwandte Endpoints

Keine — Health ist orthogonal zum Datenmodell.