---
title: "Gets the structured data for a note."
method: GET
path: "/api/v1/ambient/note/{note_id}/structured-data"
tags: ["/api/v1/ambient/note"]
---

# Gets the structured data for a note.

`GET /api/v1/ambient/note/{note_id}/structured-data`

## Path parameters

- `note_id` string, required

## Headers

- `sdp_provider_id` string

## Response `200`

Success Response

- ControllersGetNoteStructuredDataResponse — Accumulated diagnoses and orders across sessions in the note.
  - `structured_data` ControllersStructuredData
    - `diagnoses` ControllersDiagnoses
      - `values` ControllersDiagnosisResponse[] — list of diagnoses
        - `codes` ControllersCode[] — Codes associated with the diagnosis
          - `code` string — Code value
          - `description` string — Description of the code
          - `type` 'UNSPECIFIED' | 'IMO' | 'ICD10' | 'SNOMED'
        - `diagnosis_note` string — Diagnosis note
        - `laterality_indicator` integer — Laterality indicator
        - `post_coord_lex_flag` integer — Post-coordination lexical flag
    - `orders` ControllersOrders
      - `medication_orders` ControllersMedicationOrders
        - `partial_values` ControllersMedicationOrderResponse[] — Medication Orders that are not submittable (Criteria decided based on target_emr provided in EmrContext)
          - `dosage` ControllersDosage
            - `quantity` number — (Optional) Dosage quantity
            - `raw_value` string — (Optional) Raw dosage text
            - `unit` string — (Optional) Dosage unit
          - `drug_name` string — Full medication name
          - `duration_in_days` integer — Duration in days
          - `end_date` string — End date-time (RFC3339)
          - `format` ControllersFormat
            - `raw_value` string — (Optional) Raw medication form
          - `frequency` ControllersFrequency
            - `raw_value` string — (Optional) Raw frequency text
            - `structured_value` string — (Optional) Frequency enum
          - `instructions` string — Free-form instructions
          - `linked_diagnosis_codes` ControllersLinkedDiagnosisCode[] — Linked ICD10 diagnosis codes
            - `code` string — (*Required) Diagnosis code value
            - `type` string — (*Required) Diagnosis coding system
          - `medication_code` ControllersMedicationCode
            - `code` string — (*Required) Medication code value
            - `type` 'RXCUI' | 'NDC' — (*Required) Medication coding system
          - `medication_timing` ControllersMedicationTiming
            - `raw_value` string — (Optional) Raw timing text
            - `structured_value` string — (Optional) Medication timing enum
          - `number_of_refills` integer — Number of refills
          - `quantity_dispensed` string — Quantity dispensed
          - `route` ControllersRoute
            - `raw_value` string — (Optional) Raw administration route
          - `start_date` string — Start date-time (RFC3339)
          - `status` 'ACTIVE' | 'DISCONTINUED' | 'REFILLED' — Order status
          - `strength` ControllersStrength
            - `raw_value` string — (Optional) Raw strength value
        - `values` ControllersMedicationOrderResponse[] — Emr Submittable medication Orders (Criteria decided based on target_emr provided in EmrContext)
          - `dosage` ControllersDosage
            - `quantity` number — (Optional) Dosage quantity
            - `raw_value` string — (Optional) Raw dosage text
            - `unit` string — (Optional) Dosage unit
          - `drug_name` string — Full medication name
          - `duration_in_days` integer — Duration in days
          - `end_date` string — End date-time (RFC3339)
          - `format` ControllersFormat
            - `raw_value` string — (Optional) Raw medication form
          - `frequency` ControllersFrequency
            - `raw_value` string — (Optional) Raw frequency text
            - `structured_value` string — (Optional) Frequency enum
          - `instructions` string — Free-form instructions
          - `linked_diagnosis_codes` ControllersLinkedDiagnosisCode[] — Linked ICD10 diagnosis codes
            - `code` string — (*Required) Diagnosis code value
            - `type` string — (*Required) Diagnosis coding system
          - `medication_code` ControllersMedicationCode
            - `code` string — (*Required) Medication code value
            - `type` 'RXCUI' | 'NDC' — (*Required) Medication coding system
          - `medication_timing` ControllersMedicationTiming
            - `raw_value` string — (Optional) Raw timing text
            - `structured_value` string — (Optional) Medication timing enum
          - `number_of_refills` integer — Number of refills
          - `quantity_dispensed` string — Quantity dispensed
          - `route` ControllersRoute
            - `raw_value` string — (Optional) Raw administration route
          - `start_date` string — Start date-time (RFC3339)
          - `status` 'ACTIVE' | 'DISCONTINUED' | 'REFILLED' — Order status
          - `strength` ControllersStrength
            - `raw_value` string — (Optional) Raw strength value

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/suki/apis/suki-developer-platform.md) · [All operations](https://skmtc.dev/suki/apis/suki-developer-platform/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/suki/suki-developer-platform/revisions/5f420a18fb68/schema)