Viewing Records & Bills

What patients can see in their portal — appointments, prescriptions, reports, and bills.

Patients can access their clinical records, bills, and documents through the patient portal. All data is strictly scoped to the authenticated patient.

Clinical Records Available

Patients can view the following record types from their visits:

Vitals

Vital signs recorded during hospital visits, including the recording timestamp and associated visit. Vitals are viewable for all visits linked to the patient.

Consultation Notes

Notes written by doctors during appointments, including:

Chief complaint and history of present illness
Examination findings and diagnosis
Medical advice and whether a follow-up is recommended
Signed status (notes are finalized when signed by the doctor)

Only notes from completed visits are visible to patients.

Prescriptions

Issued prescriptions with full medication details:

Drug name, dosage, frequency, and duration for each medication
Whether a drug is substitutable (generic alternatives allowed)
Whether a medication is SOS (as-needed basis)
Prescription status: patients see ISSUED and DISPENSED prescriptions

Draft prescriptions are not visible to patients — only prescriptions that have been formally issued by the doctor.

Test Requests & Reports

Test Requests: lab test orders placed by the doctor, including priority level, clinical notes, fasting requirements, and special instructions
Reports: diagnostic reports are visible only after they are VERIFIED and DELIVERED. Draft and pending-verification reports are hidden from patients

Documents

Uploaded documents such as external lab reports, imaging results, and referral letters:

Each document has a type, category, file URL, and upload source
Document categories are configurable per tenant
Only active (non-deleted) documents are visible
Documents include verification status

Filtering Records

All clinical record endpoints support the following filters:

Filter	Description
Visit UUID	View records from a specific visit
Doctor UUID	View records from a specific doctor (notes, prescriptions)
Status	Filter by record status (e.g., only ISSUED prescriptions)
Date Range	Filter by date (from/to epoch seconds)
Pagination	Cursor-based with configurable page size (default 20, max 50)

Bills

Patients can view their hospital bills:

Bill List

Lists all bills with filtering by status, centre, and date range. Bills in DRAFT status are not visible to patients — only ISSUED and beyond.

Bill Details

Each bill includes:

Bill number and dates (issued, due)
Itemized line items with descriptions, quantities, unit prices, discounts, taxes, and line totals
Item types: CONSULTATION, TEST, SCAN, MEDICINE, PROCEDURE, SERVICE, PACKAGE, ADJUSTMENT
Summary totals: subtotal, total discount, total tax, grand total
Payment status and transaction references

Online Payment

From the bill detail view, patients can initiate online payment:

Only available for bills in ISSUED or PARTIALLY_PAID status
Generates a payment link (Razorpay) with an expiry
Returns the payment URL and order ID for the patient to complete payment

Bill PDF Download

Patients can download a PDF version of their bill. If a PDF was previously generated, the existing URL is returned. Otherwise, a new PDF is generated on demand from the bill template.

Deposits

Patients can view their deposit (advance payment) accounts:

Current balance and transaction history
Status: ACTIVE (funds available), FULLY_USED (balance zero), CLOSED, or REFUNDED
Individual transactions showing deposits, usages against bills, and refunds

Data Visibility Rules

Not all data is visible to patients:

Visible	Not Visible
Signed consultation notes	Draft notes
Issued/dispensed prescriptions	Draft prescriptions
Verified/delivered reports	Draft or pending-verification reports
Active documents	Deleted or internal-only documents
Issued bills and beyond	Draft bills
Own records only	Other patients' data

patient-portalrecordsbillsprescriptionsreports

Viewing Records & Bills