Pharmacy API

Top-level endpoints

Pharmacy Workflows

Complete workflows for building a fully functional pharmacy application, including OTC sales, prescription dispensing, inventory management, and compliance.

Products (OTC catalog)

Manage OTC products sold at pharmacies.

{
  "id": "prod-abc-123",
  "name": "Paracetamol 500mg",
  "sku": "PARA-500",
  "category": "analgesic",
  "retail_price": 500,
  "stock_quantity": 120,
  "inventory_item": "inv-111-222",
  "is_active": true
}

curl -X POST https://api.mediloop.co/api/v1/sales/products/   -H "Authorization: Bearer <TOKEN>"   -H "Content-Type: application/json"   -d '{"name":"Paracetamol 500mg","sku":"PARA-500","category":"analgesic","retail_price":500.00,"stock_quantity":120}'

Sales Transactions (Point-of-Sale)

Create and manage POS transactions, process payments, and generate receipts.

curl -X POST https://api.mediloop.co/api/v1/sales/transactions/ \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"pharmacy_id":"fac-123","cashier":"alice","items":[{"product_id":"prod-abc-123","quantity":2}],"payment_method":"cash","customer_name":"John Doe","customer_phone":"+256700000000"}'

fetch('https://api.mediloop.co/api/v1/sales/transactions/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <TOKEN>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    pharmacy_id: 'fac-123',
    cashier: 'alice',
    items: [{ product_id: 'prod-abc-123', quantity: 2 }],
    payment_method: 'cash'
  })
}).then(r => r.json()).then(console.log).catch(console.error);

{
  "id": "txn-111-222",
  "transaction_number": "TXN-0001",
  "pharmacy": "fac-123",
  "cashier": "alice",
  "subtotal": 1000,
  "tax_amount": 180,
  "discount_amount": 0,
  "total_amount": 1180,
  "payment_method": "cash",
  "payment_status": "completed",
  "status": "completed"
}

curl "https://api.mediloop.co/api/v1/sales/transactions/txn-111-222/receipt/?format=pdf"   -H "Authorization: Bearer <TOKEN>"

Consultations & Follow-ups

Create pharmacist consultations linked to transactions and schedule follow-ups with notifications.

curl -X POST https://api.mediloop.co/api/v1/sales/follow-ups/ \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"consultation":"consult-111","scheduled_at":"2025-12-21T09:00:00Z","scheduled_by":"pharm1","notes":"Check improvement"}'

{
  "id": "followup-111",
  "consultation": "consult-111",
  "scheduled_at": "2025-12-21T09:00:00Z",
  "scheduled_by": "pharm1",
  "reminder_sent": true,
  "completed": false
}

Inventory

Inventory endpoints manage stock, movements, alerts, and pharmacy locations.

curl -X POST https://api.mediloop.co/api/v1/inventory/movements/ \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"inventory_item":"inv-111","movement_type":"receipt","quantity":100,"notes":"Received PO PO-123"}'

{
  "id": "movement-111",
  "inventory_item": "inv-111",
  "movement_type": "receipt",
  "quantity": 100,
  "quantity_before": 20,
  "quantity_after": 120,
  "reference_type": "purchase_order",
  "reference_id": "PO-123"
}

Dispensing

Prescription fulfillment: manage queues, refills and dispenses.

curl -X POST https://api.mediloop.co/api/v1/dispensing/dispenses/ \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"prescription_id":"presc-111","pharmacy_id":"fac-123","pharmacist":"pharm1","items":[{"medication_code":"med-abc","quantity":1}]}'

Procurement

Suppliers, purchase orders and goods-received notes.

curl -X POST https://api.mediloop.co/api/v1/procurement/purchase-orders/ \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"supplier":"sup-111","items":[{"medication_code":"med-abc","quantity":100,"unit_price":450}],"expected_delivery":"2025-12-28"}'

{
  "id": "po-111",
  "supplier": "sup-111",
  "status": "created",
  "items": [
    {
      "medication_code": "med-abc",
      "quantity": 100,
      "unit_price": 450
    }
  ]
}

Inventory Management

Track stock levels, record movements, and manage pharmacy locations.

curl "https://api.mediloop.co/api/v1/inventory/stock/?pharmacy=fac-123" \
  -H "Authorization: Bearer <TOKEN>"

curl -X POST https://api.mediloop.co/api/v1/inventory/movements/ \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"pharmacy_id":"fac-123","medication_code":"med-abc","movement_type":"sale","quantity":-1,"reference_type":"transaction","reference_id":"txn-111"}'

Compounding

Manage compound formulas, ingredients, and preparation records.

curl -X POST https://api.mediloop.co/api/v1/compounding/preparations/ \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"formula_id":"form-111","batch_size":10,"prepared_by":"pharm1","ingredients_used":[{"ingredient_id":"ing-abc","quantity":5}]}'

Returns

Customer and supplier return flows with destruction records.

curl -X POST https://api.mediloop.co/api/v1/returns/customer/ \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"transaction_id":"txn-111","items":[{"product_id":"prod-abc-123","quantity":1}],"reason":"expired"}'

Drug Safety

Drug interaction checks, recalls and alerts to keep dispensing safe.

curl "https://api.mediloop.co/api/v1/drug-safety/interactions/?items=med-abc,med-def" \
  -H "Authorization: Bearer <TOKEN>"

Cold Chain

Temperature readings, storage units and excursion alerts for temperature-sensitive products.

Quality Management (QMS)

Incident reporting, CAPA, and audits to support regulatory compliance.

curl -X POST https://api.mediloop.co/api/v1/quality/incidents/ \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"reported_by":"staff-1","summary":"Temperature excursion","details":"Cold room was 12°C for 2 hours","severity":"high","attachments":[]}'

Analytics & Forecasting

Sales summary, top products, basket analysis, and persisted forecasts.

Billing & Notifications

The pharmacy service integrates with a separate Billing service for creating charges and payments, and with a Notification (WhatsApp) service for sending messages and reminders.

curl -X POST https://billing.mediloop.co/api/v1/charges/ \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"patient_uhid":"UG123","service_code":"otc_sales","service_description":"OTC sale TXN-123","quantity":1,"reference_type":"SalesTransaction","reference_id":"txn-111","pharmacy_id":"fac-123"}'

{
  "id": "charge-abc-123",
  "status": "created",
  "total_amount": 1180,
  "currency": "UGX"
}

curl -X POST https://notifications.mediloop.co/api/v1/notifications/send/   -H "Authorization: Bearer <TOKEN>"   -H "Content-Type: application/json"   -d '{"recipient":"+256700000000","template":"dispense_ready","parameters":{"medication_name":"Paracetamol"}}'

Errors & Integration notes

You can download a small Postman starter collection for Pharmacy endpoints from docs/postman/MediLoop_Pharmacy.postman_collection.json. This collection includes sample requests for Products and Transactions to help you start building a frontend quickly.

Common error patterns for pharmacy endpoints:

• All endpoints expect a valid JWT Authorization header: Authorization: Bearer <token>.
• For POS flows, ensure transaction create → (billing charge) → payment → complete sequence is followed to keep records consistent.
• Use the /api/v1/sales/transactions/{transaction_id}/receipt/?format=pdf endpoint to generate receipt PDFs for printing or email.
• Notification and billing integrations are synchronous in the API paths — handle 502/503 and retry according to network best practices.
• Consider using the analytics endpoints to pre-populate recommended merchandising and purchase order suggestions.