Developer Resources
Build on top of Vitora HMIS with our REST API, FHIR R4 resources, and real-time WebSocket events.
REST API
Django REST Framework with JWT auth, cursor pagination, filtering, and field-level permissions.
- ✓ Patients, Encounters, Pharmacy, Lab, Billing
- ✓ Scheduling & shift management
- ✓ SHA eligibility & claims APIs
- ✓ Audit logging on every operation
FHIR R4
HL7 FHIR R4 interoperability for HIE integration and cross-system data exchange.
- ✓ Patient, Encounter, Observation resources
- ✓ Kenya-specific profiles
- ✓ Bundle & search operations
- ✓ HAPI FHIR tested
Real-Time Events
WebSocket channels for live notifications, queue updates, and critical alerts.
- ✓ Django Channels (ASGI)
- ✓ Domain event publishing
- ✓ Triage queue updates
- ✓ Critical lab value alerts
Sample API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/token/ | JWT authentication (username or email) |
| GET | /api/patients/ | List patients (paginated, filterable) |
| POST | /api/patients/ | Register new patient (auto-generates MRN) |
| GET | /api/encounters/ | List clinical encounters |
| POST | /api/encounters/ | Create encounter with vitals |
| GET | /api/locations/counties/ | Kenya 47-county hierarchy |
Full API documentation with 80+ endpoints available to integration partners.
Authentication
JWT (access + refresh tokens) with httpOnly cookie support. Login by username or email. MFA enforcement for privileged roles. Active shift enforcement for clinical write operations.
Offline Sync
Bi-directional sync. Client reads from local SQLite, writes via REST API. Automatic conflict resolution on reconnect. 18 synced tables across 3 scopes.
Ready to Integrate?
API documentation and sandbox access are available to registered facilities and integration partners.