Public Healthcare REST API · v1.0

Healthcare APIs for Builders & Innovators

Integrate verified doctor directories, licensed pharmacies, real-time availability slots, and telemedicine consultations into your mobile apps, web systems, or WhatsApp AI bots.

Build WhatsApp Chatbot

Doctors Directory API

Search qualified medical practitioners by specialty, clinic address, city, consultation fees, and real-time availability.

Pharmacies Network API

Find nearby licensed pharmacies, delivery modes (PointLink network & self-delivery), and coordinates.

Zimflow Low-Code Integration

Connect our REST endpoints directly to Zimflow.co.zw to deploy WhatsApp healthcare chatbots in minutes.

Featured Integration · Low-Code Automation

Build Telemedicine WhatsApp AI Chatbots in Minutes with Zimflow

Zimflow is a visual, low-code WhatsApp chatbot and conversational AI workflow builder powered by visual node flows and generative AI (OpenAI & Gemini). With Zimflow and Chiremba APIs, you can build production-ready digital healthcare assistants without writing complex server code.

1. WhatsApp Doctor Booking Bot

Use Zimflow's HTTP Node to call /api/v1/doctors. Patients on WhatsApp can view available doctors by specialty, see consultation fees, and schedule appointments instantly.

2. WhatsApp Pharmacy Finder Bot

Patients share their WhatsApp GPS location. Zimflow queries /api/v1/pharmacies and returns nearby pharmacies with home delivery and phone contacts.

3. AI Symptom Triage Assistant

Zimflow AI Assistant nodes understand natural language in Shona, Ndebele, or English. It queries Chiremba's clinical departments (/api/v1/departments) and directs patients to the right medical specialist.

Get Started on Zimflow.co.zw No complex backend required · Ready in minutes with visual flows

Authentication & Quickstart

Authenticate all HTTP requests by sending your unique API Key via the X-API-KEY header or Bearer Token.

1 Generate API Key

Click Get API Key above to register your application and immediately receive your ch_live_... key.

2 Include X-API-KEY Header

Pass X-API-KEY: ch_live_your_key in headers on all calls to /api/v1/*.

3 Standard JSON Responses

All responses return clean UTF-8 JSON with pagination metadata and standard HTTP error codes.

cURL Example

curl -X GET "https://chirembaexpress.co.zw/api/v1/doctors?city=Harare" \
  -H "X-API-KEY: ch_live_your_api_key_here" \
  -H "Accept: application/json"

API Reference (v1)

Explore the complete schema for certified doctors, pharmacies, and clinical departments.

GET /api/v1/doctors Certified Medical Practitioners

Returns list of verified, active doctors with fees, locations, and specialties.

Query Parameters:

department_id (integer, optional): Filter by medical specialty ID
city (string, optional): Filter by doctor's clinic city
page (integer, optional): Pagination page number (default 1)

// 200 OK Response Sample { "success": true, "data": [ { "id": 12, "name": "Dr. Sarah Dube", "specialty": "Pediatrics", "consultation_fee": 35.00, "city": "Harare", "address": "Baines Medical Centre", "latitude": -17.8216, "longitude": 31.0492 } ], "pagination": { "total": 48, "current_page": 1, "per_page": 20 } }

GET /api/v1/pharmacies Licensed Pharmacies & Dispensaries

Returns active pharmacies, fulfillment modes, and delivery logistics details.

Query Parameters:

city (string, optional): Filter by pharmacy city
page (integer, optional): Pagination page number

// 200 OK Response Sample { "success": true, "data": [ { "id": 5, "pharmacy_name": "MedHelp Central Pharmacy", "phone": "+263771234567", "address": "45 Samora Machel Ave, Harare", "delivery_mode": "pointlink", "latitude": -17.8286, "longitude": 31.0534 } ], "pagination": { "total": 22, "current_page": 1, "per_page": 20 } }

GET /api/v1/departments Medical Specialties Directory

Returns medical departments and clinical categories available on Chiremba.