> ## Documentation Index > Fetch the complete documentation index at: https://docs.healos.ai/llms.txt > Use this file to discover all available pages before exploring further. # List notes for a session > All clinical notes generated for a session, plus the session's transcript/summary and the patient context. Returns 404 if the session isn't owned by your organization. ## OpenAPI ````yaml /openapi/ext-api-v1.json get /sessions/{sessionId}/notes openapi: 3.0.0 info: title: Healos External API version: 1.0.0 description: >- External API for managing patients, documents, and appointments, listing providers, and for pulling clinical notes (with transcript and patient context). servers: - url: https://api.healos.ai/ext-api/v1 description: Production - url: http://localhost:8787/ext-api/v1 description: Local development security: - ApiKeyAuth: [] paths: /sessions/{sessionId}/notes: get: tags: - Notes summary: List notes for a session description: >- All clinical notes generated for a session, plus the session's transcript/summary and the patient context. Returns 404 if the session isn't owned by your organization. parameters: - schema: type: string description: Session UUID example: f47ac10b-58cc-4372-a567-0e02b2c3d479 required: true name: sessionId in: path responses: '200': description: Session notes bundle content: application/json: schema: $ref: '#/components/schemas/SessionNotesResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Insufficient scope content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Session not found content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/RateLimitError' components: schemas: SessionNotesResponse: type: object properties: data: type: object properties: session: type: object properties: id: type: string patient_id: type: string nullable: true transcript: $ref: '#/components/schemas/NoteTranscript' required: - id - patient_id - transcript patient: $ref: '#/components/schemas/NotePatientContext' notes: type: array items: $ref: '#/components/schemas/NoteDetail' required: - session - patient - notes required: - data Error: type: object properties: error: type: string required: - error RateLimitError: type: object properties: error: type: string example: Rate limit exceeded. Please retry after the window resets. required: - error NoteTranscript: type: object nullable: true properties: text: type: string nullable: true description: Full session transcript. summary: type: string nullable: true description: Session summary. title: type: string nullable: true example: Follow-up visit status: type: string nullable: true description: Transcript status. example: completed session_date: type: string nullable: true description: Session date (ISO 8601). start_time: type: string nullable: true description: Session start (ISO 8601). end_time: type: string nullable: true description: Session end (ISO 8601). required: - text - summary - title - status - session_date - start_time - end_time description: Included unless excluded via `include`. NotePatientContext: type: object nullable: true properties: id: type: string example: '481926357104938271' name: type: string nullable: true example: Maria Santos first_name: type: string nullable: true last_name: type: string nullable: true pronouns: type: string nullable: true example: she/her date_of_birth: type: string nullable: true example: '1985-04-12' gender: type: string nullable: true example: female email: type: string nullable: true phone: type: string nullable: true mrn: type: string nullable: true example: MRN-00123 client_history: $ref: '#/components/schemas/ClientHistory' required: - id - name - first_name - last_name - pronouns - date_of_birth - gender - email - phone - mrn - client_history description: Included unless excluded via `include`. NoteDetail: allOf: - $ref: '#/components/schemas/NoteListItem' - type: object properties: content: type: string nullable: true description: The clinical note body. problems: type: array items: type: string example: - Hypertension procedures: type: array items: type: string example: - 12-lead ECG icd10_codes: type: object nullable: true additionalProperties: nullable: true description: 'ICD-10 codes, e.g. { "I10": "Essential hypertension" }' cpt_codes: type: object nullable: true additionalProperties: nullable: true description: CPT codes keyed by procedure. transcript: $ref: '#/components/schemas/NoteTranscript' patient: $ref: '#/components/schemas/NotePatientContext' required: - content - problems - procedures - icd10_codes - cpt_codes - transcript - patient ClientHistory: type: object nullable: true properties: medical_history: type: string nullable: true family_history: type: string nullable: true social_history: type: string nullable: true previous_treatment: type: string nullable: true required: - medical_history - family_history - social_history - previous_treatment NoteListItem: type: object properties: id: type: string example: 9b2d4f6a-1c3e-4a5b-8d7f-0e1a2b3c4d5e patient_id: type: string nullable: true example: '481926357104938271' session_id: type: string nullable: true example: f47ac10b-58cc-4372-a567-0e02b2c3d479 note_type: type: string nullable: true example: clinical_visit specialty: type: string nullable: true example: Cardiology template_id: type: string nullable: true template_name: type: string nullable: true example: Follow-Up Patient Visit created_at: type: string nullable: true example: '2026-03-15T09:30:00.000Z' updated_at: type: string nullable: true example: '2026-03-15T10:00:00.000Z' required: - id - patient_id - session_id - note_type - specialty - template_id - template_name - created_at - updated_at securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: API key obtained from /api/v1/ext-api-keys ````