Get Ambient Encounter Content

Retrieve generated clinical content from completed encounter

GET /api/v1/ambient/encounter/{encounter_id}/content

cURL

cURL

curl --request GET \
  --url https://sdp.suki.ai/api/v1/ambient/encounter/<encounter_id>/content \
  --header 'sdp_suki_token: <sdp_suki_token>' \
  --header 'sdp_provider_id: <sdp_provider_id>'

200

{
  "structured_data": [
    {
      "data": {
        "dosage": "2 puffs",
        "medication": "albuterol"
      },
      "title": "MEDICATIONS"
    }
  ],
  "summary": [
    {
      "content": "Asthma exacerbation",
      "loinc_code": "18776-5",
      "source_transcripts": [
        "asthma",
        "exacerbation"
      ],
      "title": "ASSESSMENT AND PLAN"
    }
  ]
}

Updated:

You can now get the Medication orders for an encounter from the encounter content response. Read more in Medication orders.

Use this endpoint to get the cumulative summary and structured data associated with the specified encounter.

Code examples

Python

import requests

encounter_id = "123dfg-456dfg-789dfg-012dfg"
url = f"https://sdp.suki-stage.com/api/v1/ambient/encounter/{encounter_id}/content"

headers = {
    "sdp_suki_token": "<sdp_suki_token>",
    "sdp_provider_id": "<sdp_provider_id>"
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    content = response.json()
    print("Encounter Summary:")
    for section in content.get("summary", []):
        print(f"\nTitle: {section.get('title')}")
        print(f"LOINC Code: {section.get('loinc_code')}")
        print(f"Content: {section.get('content')}")
    
    print("\nStructured Data:")
    for structured_block in content.get("structured_data", []):
        print(f"\n{structured_block.get('title')}:")
        # data is a key-value object
        data = structured_block.get('data', {})
        for key, value in data.items():
            print(f"  {key}: {value}")
else:
    print(f"Failed to get encounter content: {response.status_code}")
    print(response.json())

TypeScript

const encounterId = '123dfg-456dfg-789dfg-012dfg';
const response = await fetch(
  `https://sdp.suki-stage.com/api/v1/ambient/encounter/${encounterId}/content`,
  {
    headers: {
      'sdp_suki_token': '<sdp_suki_token>',
    'sdp_provider_id': '<sdp_provider_id>'
    }
  }
);

if (response.ok) {
  const content = await response.json();
  console.log('Encounter Summary:');
  content.summary?.forEach((section: any) => {
    console.log(`\nTitle: ${section.title}`);
    console.log(`LOINC Code: ${section.loinc_code}`);
    console.log(`Content: ${section.content}`);
  });
  
  console.log('\nStructured Data:');
  content.structured_data?.forEach((structuredBlock: any) => {
    console.log(`\n${structuredBlock.title}:`);
    // data is a key-value object
    if (structuredBlock.data) {
      Object.entries(structuredBlock.data).forEach(([key, value]) => {
        console.log(`  ${key}: ${value}`);
      });
    }
  });
} else {
  const error = await response.json();
  console.error(`Failed to get encounter content: ${response.status}`, error);
}

Related guides

Medication Orders

Convert medication instructions from ambient encounters into structured Medication order data

Learn more

Authorizations

sdp_suki_token · string · header · required

Suki access token (suki_token) from Login or Register. Expires after one hour.

Headers

sdp_provider_id · string

Optional for standard partners.

Required for:

• Bearer authentication. Use the same provider_id returned by the Login or Register API.
• Single Auth Token authentication. Include the same provider_id on every request as sdp_provider_id.

Example:

"provider-123"

Path Parameters

encounter_id · string · required

UUID for the patient encounter (visit). Use the encounter_id from session create or the UUID you assigned when grouping multiple sessions under one visit.

Response

200

application/json

Request succeeded.

Response body for the /encounter/{encounter_id}/content endpoint

structured_data · object[]

Structured data extracted from the encounter

Show child attributes

summary · object[]

Cumulative summary of the encounter

Show child attributes