---
title: "Get encounter structured data"
method: GET
path: "/api/v1/ambient/encounter/{encounter_id}/structured-data"
tags: ["/api/v1/ambient/encounter"]
---

# Get encounter structured data

`GET /api/v1/ambient/encounter/{encounter_id}/structured-data`

Returns structured clinical data aggregated across all ambient sessions for the encounter. Use the `encounter_id` from session create.

## Path parameters

- `encounter_id` string, required

## Headers

- `sdp_provider_id` string

## Response `200`

Request succeeded.

- ControllersEncounterStructuredDataResponse — Response body for the /encounter/{encounter_id}/structured-data endpoint
  - `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. The request body or parameters failed validation.
- `401` — Unauthorized. The Suki access token is missing, expired, or invalid.
- `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)