Meditech API Reference

Welcome to the Meditech API. Our RESTful API allows developers to integrate seamlessly with the Medtimes healthcare ecosystem, enabling consumers to discover doctors, book appointments, order pharmacy products, and manage their health records securely. It also provides core integration points for our wellness partners.

Base URL

https://api.meditech.bio/api/v1

Authentication

The Meditech API uses standard Bearer Token authentication. Patient tokens are acquired via the LoginController upon successful user authentication. Enterprise wellness partners receive a static API key for Core API integrations. Ensure all API requests to protected endpoints include the Authorization header.

HTTP Request Header

Authorization: Bearer <your_access_token>
Accept: application/json
Content-Type: application/json

Doctors & Departments

Endpoints to retrieve available medical departments, specializations, and doctors on the Medtimes platform.

GET /departments

Retrieves a list of all active medical departments and specializations.

Response (200 OK)

{
  "status": "success",
  "data": [
    {
      "id": 1,
      "name": "Cardiology",
      "icon_url": "https://cdn.meditech.bio/icons/cardio.png"
    }
  ]
}

GET /doctors

Retrieves a paginated list of doctors. You can filter this using query parameters.

Parameter	Type	Description
department_id	Integer	Filter doctors by a specific department.
search	String	Search by doctor's name.

GET /doctors/{id}/reviews

Fetches verified patient reviews for a specific doctor.

Appointments

Manage physical and video telehealth appointments.

GET /time-slots/{doctor_id}

Retrieves available time slots for a specific doctor on a given date. Use /time-slots-video/{doctor_id} for telehealth availability.

Query Param	Required	Description
date	Yes	The target date in `YYYY-MM-DD` format.

POST /appointments/book

Book a new physical or video appointment.

Request Body

{
  "doctor_id": 45,
  "date": "2026-03-20",
  "time_slot": "14:30",
  "type": "video",
  "patient_notes": "Experiencing mild headaches."
}

POST /appointments/{id}/cancel

Cancel an upcoming appointment. Processed via AppointmentCancellationRedController.

Pharmacy & Orders

Access the e-Pharmacy platform to browse products, check availability, and place medicine orders.

GET /products

List active pharmaceutical products. Can be filtered by category ID from /product-categories.

POST /orders

Place a new pharmacy order for the authenticated patient.

Request Body

{
  "address_id": 12,
  "payment_method": "stripe",
  "items": [
    { "product_id": 102, "quantity": 2 },
    { "product_id": 55, "quantity": 1 }
  ]
}

GET /allow-pincode/{pincode}

Validate if delivery is available for the given pincode (zip code).

Lab Tests & Diagnostics

Discover diagnostic lab tests and submit requests for home collection or clinic visits.

GET /lab-tests

Retrieve a catalog of available lab tests (e.g., Complete Blood Count, Lipid Profile).

POST /lab-requests

Submit a new request for a diagnostic lab test.

Prescriptions & Invoices

Access medical history, download digital prescriptions, and view appointment invoices.

GET /prescriptions

Get all digital prescriptions issued to the authenticated patient.

GET /prescription/generatePDF/{id}

Download a specific prescription as a standardized PDF document.

GET /invoice/generatePDF/{id}

Generate and download an official tax invoice PDF for a completed appointment. Use /invoice/generatePDFLab/{id} for lab invoices.

Telehealth API Partners

Exclusive endpoints for wellness partners to embed and manage secure virtual consultation rooms directly within their own applications.

POST /partner/telehealth/rooms

Generate a secure video consultation room link for wellness program members.

Request Body

{
  "partner_id": "wp_88321",
  "patient_identifier": "ext_usr_901",
  "scheduled_at": "2026-04-10T10:00:00Z"
}

Billing API Partners

Manage enterprise billing, track invoices, and process bulk payments for partner-referred appointments and laboratory tests.

GET /partner/billing/statements

Retrieve aggregated, itemized billing statements for a specific billing cycle.

POST /partner/billing/payments

Submit a payment against an open enterprise invoice.

Events API Partners

Real-time webhook subscriptions designed to sync Medtimes activity with your wellness platforms seamlessly.

POST /partner/webhooks/subscribe

Register a destination URL to receive live event payloads such as appointment.completed or lab.result_ready.

Request Body

{
  "target_url": "https://wellness-app.com/api/medtimes-events",
  "events": ["appointment.completed", "lab.result_ready"]
}

Errors

Meditech API uses conventional HTTP response codes to indicate the success or failure of an API request.

Code	Description
200 - 201	Everything worked as expected.
400	Bad Request. Often due to missing or invalid parameters.
401	Unauthorized. Invalid or missing Bearer token.
403	Forbidden. The user does not have permissions for this action.
404	Not Found. The requested resource does not exist.
500	Internal Server Error. Something went wrong on Medtimes' end.

Webhooks

Our platform automatically listens for external payment gateway webhooks.

POST /rz_webhook (Razorpay Integration)
POST /stripe_webhook (Stripe Integration)