Hospital OS API
Katixo Hospital OS is a comprehensive hospital management platform covering the full clinical and operational workflow — from patient registration through OPD/IPD to laboratory, operation theatre, pharmacy, and billing. The API is organized into three services:
Hospital Service — Core clinical and operational APIs: patients, OPD appointments, IPD admissions, laboratory, and OT management.
ERP Service — Business operations: pharmacy billing, inventory and stock management, GST compliance, payment processing, and financial ledgers.
Integration Service — External integrations: WhatsApp notifications, ABDM (Ayushman Bharat Digital Mission), and AI-powered features.Coming Soon
Base URL
https://hospital.katixo.com/api/v1Architecture
Hospital OS is built as a monorepo with shared libraries that provide cross-cutting concerns:
common-libBase response structures, exception handling, pagination, and utility functions.security-libJWT authentication, authorization, current user context, and permission management.tenant-libMulti-tenant support with tenant/group/branch context and filtering.erp-clientTyped internal API client enabling hospital service to call ERP service endpoints.Authentication
Hospital OS uses the same JWT authentication as the Katasticho ERP. See the shared Authentication documentation for details on obtaining tokens, roles, and multi-tenant context.
The JWT token includes tenantId, groupId, and branchId claims that scope all API requests to the correct hospital and branch.
Resources
Patients
Patient registration, search, demographics, and medical record numbers.
OPD
Appointments, token queue, consultations, and prescriptions.
IPD
Admissions, bed/ward management, treatment charts, and discharge.
Laboratory
Test catalog, sample collection, processing, and reports.
Operation Theatre
Surgery scheduling, OT booking, surgical team, and notes.
Pharmacy
Drug dispensing, prescription fills, batch tracking, and returns.
Billing
Patient billing, package billing, payments, receipts, and refunds.