The Care Nexus LogoThe Care Nexus
The Care Nexus LogoCareNexus Docs

API Reference

Complete REST API documentation — all endpoints, request formats, and response schemas.

Updated June 2026 12 min read

This page documents all available REST API endpoints in The Care Nexus. The base URL for all endpoints in development is http://localhost:5000/api. In production, replace with your deployed backend URL.

All protected endpoints require a valid JWT token in Authorization: Bearer <token>.

Authentication

MethodEndpointAuthDescription
POST/auth/registerNoneCreate account
POST/auth/loginNoneLogin user
POST/auth/logoutBearerInvalidate session
POST/auth/refreshNoneRefresh token
POST/auth/forgot-passwordNoneSend reset email
POST/auth/reset-password/:tokenNoneReset password
GET/auth/verify/:tokenNoneVerify email

Patient Endpoints

MethodEndpointDescription
GET/patient/dashboardDashboard stats
GET/patient/profileGet profile
PUT/patient/profileUpdate profile
GET/patient/appointmentsList appointments
POST/patient/appointmentsBook appointment
PUT/patient/appointments/:id/cancelCancel appointment
GET/patient/recordsMedical records
GET/patient/records/:idRecord detail
GET/patient/familyFamily members
POST/patient/familyAdd family member
PUT/patient/family/:memberIdUpdate family member
DELETE/patient/family/:memberIdDelete family member
GET/patient/family/:memberId/recordsFamily records

Doctor Endpoints

MethodEndpointDescription
GET/doctor/patientsPatient list
POST/doctor/patientsAdd patient
GET/doctor/patients/:idPatient detail
DELETE/doctor/patients/:idRemove patient
GET/doctor/appointmentsAppointments queue
PUT/doctor/appointments/:idUpdate status
GET/doctor/prescriptionsPrescription history
POST/doctor/prescriptionsCreate prescription
PUT/doctor/prescriptions/:idEdit prescription
DELETE/doctor/prescriptions/:idDelete prescription
GET/doctor/scheduleGet schedule
PUT/doctor/scheduleUpdate schedule
GET/doctor/revenueRevenue data

Clinic Admin Endpoints

MethodEndpointDescription
GET/clinic/analytics/overviewKPIs
GET/clinic/analytics/patient-flowPatient flow
GET/clinic/analytics/revenueRevenue analytics
GET/clinic/doctorsDoctors list
POST/clinic/doctorsInvite doctor
DELETE/clinic/doctors/:idRemove doctor
GET/clinic/doctors/:id/statsDoctor stats
GET/clinic/appointmentsAll appointments
GET/clinic/settingsClinic settings
PUT/clinic/settingsUpdate settings
GET/clinic/staffStaff list
POST/clinic/staffCreate staff
PUT/clinic/staff/:idUpdate staff
DELETE/clinic/staff/:idDelete staff

AI Endpoints

MethodEndpointDescription
POST/ai/gemini/chatAI chat
POST/ai/chat/transcribeVoice transcription
POST/ai/gemini/parse-prescriptionParse prescription

Response envelope

All responses follow: { success, message, data, statusCode }