Skip to main content
GET
/
notes
/
summary
/
{id}
curl -X GET \
  'https://app.medisync.me/api/notes/summary/664e0b1f7c2a5e0011fa9911' \
  -H 'Authorization: Bearer your_jwt_token_here'

const response = await fetch(
  'https://app.medisync.me/api/notes/summary/664e0b1f7c2a5e0011fa9911',
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer your_jwt_token_here'
    }
  }
);

const result = await response.json();

import requests

response = requests.get(
    'https://app.medisync.me/api/notes/summary/664e0b1f7c2a5e0011fa9911',
    headers={
        'Authorization': 'Bearer your_jwt_token_here'
    }
)

result = response.json()

{
  "success": true,
  "data": {
    "summary": "Chest pain, normal findings, continue monitoring"
  }
}

​
Overview

Retrieve just the summary of the notes for a specific appointment. This returns only the summary field, providing a quick overview without the full clinical content. Use Get Notes by Appointment to retrieve the complete notes.
This operation is scoped to the owning doctor. The appointment identified by {id} must belong to the authenticated user. A request for an appointment you do not own returns 403 Forbidden, and an unknown appointment returns 404 Appointment not found.

​
Authentication

​
Authorization
string
required
Bearer token for authenticated access. The doctor (user) identity is taken from the JWT.
Authorization: Bearer your_jwt_token_here
A missing or invalid token returns 401 with a message field. See Error Responses.

​
Path Parameters

​
id
string
required
Appointment ID (MongoDB ObjectId, 24 hex characters) whose notes summary to retrieve. Must be owned by the authenticated doctor.

​
Response

​
success
boolean
Indicates whether the operation succeeded.
​
data
object
Object containing the summary.
​
error
string
Error message (only present when success is false).

​
Example Request

curl -X GET \
  'https://app.medisync.me/api/notes/summary/664e0b1f7c2a5e0011fa9911' \
  -H 'Authorization: Bearer your_jwt_token_here'

const response = await fetch(
  'https://app.medisync.me/api/notes/summary/664e0b1f7c2a5e0011fa9911',
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer your_jwt_token_here'
    }
  }
);

const result = await response.json();

import requests

response = requests.get(
    'https://app.medisync.me/api/notes/summary/664e0b1f7c2a5e0011fa9911',
    headers={
        'Authorization': 'Bearer your_jwt_token_here'
    }
)

result = response.json()

​
Example Response

{
  "success": true,
  "data": {
    "summary": "Chest pain, normal findings, continue monitoring"
  }
}

​
Error Responses

{
  "success": false,
  "message": "Unauthorized"
}

{
  "success": false,
  "message": "Session ended on this device because you signed in elsewhere.",
  "code": "SESSION_REVOKED"
}

{
  "success": false,
  "error": "Forbidden"
}

{
  "success": false,
  "error": "Appointment not found"
}

{
  "success": false,
  "error": "Notes not found"
}

​
Behavior Notes

  • The endpoint first verifies the appointment exists and is owned by the caller, then looks up its notes.
  • There are two distinct 404 cases: the appointment does not exist (Appointment not found), or the appointment exists but has no notes (Notes not found).

​
Status Codes

  • 200 — Summary retrieved successfully.
  • 401 — Missing, invalid, or revoked authentication token.
  • 403 — Authenticated user does not own the appointment.
  • 404 — Appointment not found, or no notes exist for the appointment.