MediLoop API Reference

MediLoop is Uganda's national healthcare marketplace infrastructure. Our REST API enables you to integrate patient management, appointments, clinical data, notifications, and more into your healthcare applications.

Just getting started?

Check out our quickstart guide to make your first API call in 5 minutes.

Base URL

https://api.mediloop.co/api/v1

Client 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 mediloop

Node.js

npm install @mediloop/sdk

Java

com.mediloop:mediloop-java

Go

go get github.com/mediloop/mediloop-go

Authentication

The MediLoop API uses API keys to authenticate requests. You can view and manage your API keys in the Developer Portal.

Test mode secret keys have the prefix sk_test_ and live mode secret keys have the prefix sk_live_.

Authentication to the API is performed via HTTP Bearer Auth. Provide your API key as the bearer token value.

Authenticated Request
bash
curl https://api.mediloop.co/api/v1/patients \
  -H "Authorization: Bearer sk_test_51RHO58...T100WQd9N1qn"
# The colon prevents curl from asking for a password.
RESPONSE200
{
  "object": "list",
  "url": "/api/v1/patients",
  "has_more": false,
  "data": [
    {
      "id": "pat_1234567890",
      "object": "patient",
      "uhid": "UG123456789A",
      "first_name": "John",
      "last_name": "Doe"
    }
  ]
}

Environments

MediLoop provides two environments for development and production use.

EnvironmentBase URLDescription
Sandboxhttps://sandbox.api.mediloop.co/api/v1Test environment with simulated data
Productionhttps://api.mediloop.co/api/v1Live 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.

Related Resources