MediLoop API Reference
MediLoop is Uganda's national healthcare infrastructure. One gateway (api.mediloop.co) fronts 25 FHIR-backed microservices so you can build on identity & consent, appointments, clinical records, prescriptions, pharmacy, lab, delivery, insurance, notifications, telemedicine, AI, and a full proactive-care suite (women's, men's and child health, antenatal care, immunizations, preventive care and hereditary risk).
Every clinical datum is a FHIR R4 resource (FHIR is the single source of truth), access is consent-gated and audited, and reference data (SNOMED/LOINC/ICD) is validated by the terminology service. Below is everything you need to make your first call and find the right endpoints.
Platform capabilities
The API surface, grouped by domain. Each links to its reference.
Patients & Identity
UHID, registration, guardianship, family graph
Providers & Facilities
Practitioners, facilities, affiliations
Appointments
Booking, availability, schedules
Encounters
Clinical visits & inpatient
Observations
Vitals, labs, survey (FHIR)
Prescriptions
Medication requests & statements
Care Plans
Care plans, teams, goals
Laboratory
Orders & results
Pharmacy
Marketplace, POS, dispensing
Insurance
Coverage, eligibility, claims
Delivery
Logistics & live tracking
Notifications
SMS, push, WhatsApp, in-app
Telemedicine
WebRTC calls + reminders
Women's Health
Cycle, prediction, menopause
Antenatal Card
Pregnancy + WHO 8 contacts
Child Health
Immunizations, growth, IMCI
Men's Health
SRH, prostate, self-test
Preventive Care & Risk
Screening plan, hereditary risk
AI Services
Decision support, SOAP, copilot
Just getting started?
Check out our quickstart guide to make your first API call in 5 minutes.
Base URL
https://api.mediloop.co/api/v1Client Libraries
By default, the MediLoop API Docs demonstrate using curl to interact with the API over HTTP. Select one of our official client libraries to see examples in code.
Python
pip install mediloopNode.js
npm install @mediloop/sdkJava
com.mediloop:mediloop-javaGo
go get github.com/mediloop/mediloop-goAuthentication
The MediLoop API uses a single credential: your API key. Get it from the Developer Portal, exchange it for a short-lived access token at the Mediloop auth service, then send that token as a Bearer token on every request. Full details in Authentication.
curl -X POST https://api.mediloop.co/api/v1/auth/token \
-H "Content-Type: application/json" \
-d '{ "api_key": "sk_live_YOUR_API_KEY" }'curl https://api.mediloop.co/api/v1/uhid/UG123456789A/ \
-H "Authorization: Bearer $ACCESS_TOKEN"Environments
MediLoop provides two environments for development and production use.
| Environment | Base URL | Description |
|---|---|---|
| Sandbox | https://sandbox.api.mediloop.co/api/v1 | Test environment with simulated data |
| Production | https://api.mediloop.co/api/v1 | Live environment with real data |
Request IDs
Each API request has an associated request identifier. You can find this value in the response headers, under X-Request-Id. If you need to contact us about a specific request, providing the request identifier will ensure the fastest possible resolution.