Skip to main content

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

uid
string
required
The user ID of the healthcare provider requesting the notes

Response

success
boolean
Indicates if the operation was successful
data
array
Array of all notes objects in the system
error
string
Error message if the operation failed

Example Response

{
  "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