Skip to main content
GET
/
appointments
/
patients
List Patient's Appointments
curl --request GET \
  --url https://api.example.com/appointments/patients \
  --header 'Authorization: <authorization>'
{
  "success": true,
  "data": [
    {
      "_id": "65f8a1b2c3d4e5f6789012ef",
      "name": "Follow-up Consultation",
      "date": "2024-03-15",
      "time": "14:30",
      "recording_id": null,
      "recording_url": null,
      "recording_key": null,
      "status": "planned",
      "doctor_id": "doctor_uid_123",
      "patient_id": "patient_uid_456",
      "notes": "",
      "language": "de",
      "notes_type": "soap_clinical_notes_de",
      "appointment_type": "in_person"
    }
  ]
}

​
Overview

Returns all appointments associated with a specific patient using the patient’s ID.

​
Authentication

​
Authorization
string
required
Bearer token for authenticated access
Authorization: Bearer your_jwt_token_here

​
Query Parameters

​
uid
string
required
Patient’s user ID

​
Response

​
success
boolean
Whether the request was successful
​
data
array
Array of appointment objects for the specified patient
​
error
string
Error message (only present when success is false)

​
Example Response

{
  "success": true,
  "data": [
    {
      "_id": "65f8a1b2c3d4e5f6789012ef",
      "name": "Follow-up Consultation",
      "date": "2024-03-15",
      "time": "14:30",
      "recording_id": null,
      "recording_url": null,
      "recording_key": null,
      "status": "planned",
      "doctor_id": "doctor_uid_123",
      "patient_id": "patient_uid_456",
      "notes": "",
      "language": "de",
      "notes_type": "soap_clinical_notes_de",
      "appointment_type": "in_person"
    }
  ]
}

​
Error Response

{
  "success": false,
  "error": "Error message describing what went wrong"
}