Skip to content

REST API

The KomPACS API is a FastAPI service. The UI calls it on the same origin under /api/. The contract is an OpenAPI 3.1 document: openapi.json.

The generated pages are under API (generated).

GroupEndpoints
HealthGET /api/health
PatientsGET /api/patients?q=, GET /api/patients/{patient_id}/timeline
Triggers and casesGET /api/triggers, POST /api/triggers, GET /api/triggers/{trigger_id}
AI logGET /api/triggers/{trigger_id}/llm-trace
Candidate priorsPOST .../candidates, PATCH .../candidates/{candidate_id}, POST .../rejudge, GET .../verdicts, POST .../verdicts/{n}/restore
Queue and requestsGET /api/queue, POST /api/requests/{request_id}/approve, .../requested, .../not-found
ContactsPOST /api/contacts/lookup, PUT /api/contacts/{organization_id}
StatsGET /api/stats
Demo onlyPOST /api/demo/deliver/{request_id}, POST /api/demo/pacs-arrival/{study_id}
  • JSON in and out.
  • A Collector decision always wins over an AI verdict.
  • A failed re-judge returns 502. Nothing is stored.
  • The demo endpoints simulate a PACS arrival. They do not exist in production.