> ## 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. # Get a clinical note by ID > Full note (content + medical codes) with the session transcript and patient context embedded by default. Control embeds with the `include` query param. ## OpenAPI ````yaml /openapi/ext-api-v1.json get /notes/{noteId} 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: /notes/{noteId}: get: tags: - Notes summary: Get a clinical note by ID description: >- Full note (content + medical codes) with the session transcript and patient context embedded by default. Control embeds with the `include` query param. parameters: - schema: type: string description: Clinical note UUID example: 9b2d4f6a-1c3e-4a5b-8d7f-0e1a2b3c4d5e required: true name: noteId in: path - schema: type: string description: >- Comma-separated embedded blocks: `transcript`, `patient`. Defaults to both; pass `include=` to omit all (note body + codes always returned). example: transcript,patient required: false name: include in: query responses: '200': description: Note detail content: application/json: schema: $ref: '#/components/schemas/NoteDetailResponse' '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: Note 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: NoteDetailResponse: type: object properties: data: $ref: '#/components/schemas/NoteDetail' 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 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 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 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`. 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 securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: API key obtained from /api/v1/ext-api-keys ````