Resources · API Reference

API Reference

The full endpoint surface of the MediFlow AI backend. All paths are relative to /api.

All routes except /auth/* require a Bearer JWT tokenInteractive Swagger docs available at /docs on a running backend instance

Auth

POST	/auth/register	Create a new user account
POST	/auth/login	Authenticate and receive a JWT access token
GET	/auth/me	Return the currently authenticated user

Patients

GET	/patients	List patients
POST	/patients	Register a new patient
GET	/patients/:id	Get a single patient by ID
GET	/patients/:id/allergies	Get a patient's known allergies

Vitals

GET	/patients/:id/vitals	List recorded vitals for a patient
POST	/patients/:id/vitals	Record new vitals for a patient

Symptoms

GET	/patients/:id/symptoms	List recorded symptoms for a patient
POST	/patients/:id/symptoms	Record new symptoms for a patient

Assessment

GET	/patients/:id/assessments	List AI clinical assessments for a patient
POST	/patients/:id/assessment	Run a new AI clinical assessment
PATCH	/assessments/:id	Update doctor notes, status, or review date

Prescriptions

GET	/patients/:id/prescriptions	List prescriptions for a patient
POST	/patients/:id/prescriptions	Create a new prescription draft
POST	/prescriptions/:id/check-interactions	Run a drug interaction & allergy check
PATCH	/prescriptions/:id/doctor-review	Approve or reject as the prescribing doctor
PATCH	/prescriptions/:id/pharmacist-review	Approve or reject as the validating pharmacist
GET	/prescriptions/:id/pdf	Download the generated prescription PDF

Counselling

GET	/prescriptions/:id/counselling	List patient counselling entries for a prescription
POST	/prescriptions/:id/counselling	Generate AI patient counselling content

Follow-ups

GET	/patients/:id/appointments	List follow-up appointments for a patient
POST	/patients/:id/appointments	Schedule a follow-up appointment
GET	/prescriptions/:id/reminders	List medication reminders for a prescription
POST	/prescriptions/:id/reminders	Create medication reminders for a prescription

Notifications

GET	/notifications	List notifications for the current user
PATCH	/notifications/:id/read	Mark a notification as read

Audit

GET

/audit

List audit log entries (admin role required)

This page lists the endpoint surface only. For exact request/response schemas, validation rules, and to try requests live, run the backend and open the auto-generated Swagger UI at /docs.