Overview
Retrieve all notes from MediSync across all appointments. This endpoint returns a comprehensive list of all notes in the system, providing healthcare professionals with access to all clinical documentation.
All Notes Access : This endpoint returns all notes in the system regardless of appointment. Use the specific appointment endpoint if you need notes for a particular appointment.
Authentication
curl -X GET \
'https://api.medisync.com/notes?uid=doc_xyz789' \
-H 'Authorization: Bearer YOUR_JWT_TOKEN'
Query Parameters
The user ID of the healthcare provider requesting the notes
Response
Indicates if the operation was successful
Array of all notes objects in the system Show notes object properties
Unique identifier for the notes record
The appointment ID these notes belong to
The clinical notes content
Optional feedback score for the notes (if provided)
Optional AI-generated diagnosis prediction (if available) Show diagnosis_prediction properties
Status of the diagnosis prediction: “pending”, “generated”, or “failed”
Main diagnosis (when status is “generated”)
ICD code for the diagnosis (when status is “generated”)
Reasoning for the diagnosis (when status is “generated”)
Error message (when status is “failed”)
ISO timestamp when the notes were created
ISO timestamp when the notes were last updated
Error message if the operation failed
Example Response
Success
Success - Empty List
Error
{
"success" : true ,
"data" : [
{
"_id" : "notes_def456" ,
"appointment_id" : "apt_abc123" ,
"notes" : "Patient presented with chest pain. Physical examination revealed no acute distress. EKG normal. Plan: Continue monitoring, follow up in 1 week." ,
"summary" : "Chest pain evaluation - normal findings, continue monitoring" ,
"feedback_score" : 4.5 ,
"diagnosis_prediction" : {
"status" : "generated" ,
"main_diagnosis" : "Atypical chest pain" ,
"icd_code" : "R07.89" ,
"reason" : "Based on presentation and normal EKG findings, most likely non-cardiac chest pain"
},
"createdAt" : "2024-01-15T10:30:00.000Z" ,
"updatedAt" : "2024-01-15T11:15:00.000Z"
},
{
"_id" : "notes_ghi789" ,
"appointment_id" : "apt_def456" ,
"notes" : "Follow-up appointment for diabetes management. Blood glucose levels stable. Patient reports good adherence to medication." ,
"summary" : "Diabetes follow-up - stable management" ,
"createdAt" : "2024-01-16T14:20:00.000Z" ,
"updatedAt" : "2024-01-16T14:20:00.000Z"
}
]
}
Behavior Notes
All Notes : This endpoint returns all notes from all appointments in the system
No Filtering : The basic endpoint does not support filtering by appointment, patient, or date
Optional Fields : feedback_score and diagnosis_prediction are optional fields that may not be present in all notes
Large Datasets : Be aware that this endpoint may return large amounts of data if there are many notes in the system
Status Codes
200 - Notes retrieved successfully (including empty results)
400 - Invalid request or database error