Ambient Content Retrieval
Get Ambient Encounter Content
Retrieve generated clinical content from completed encounter
Listen to this pageabout 1 min
GET
/
api
/
v1
/
ambient
/
encounter
/
{encounter_id}
/
content
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>'import requests
url = "https://sdp.suki.ai/api/v1/ambient/encounter/{encounter_id}/content"
headers = {"sdp_suki_token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {sdp_suki_token: '<api-key>'}};
fetch('https://sdp.suki.ai/api/v1/ambient/encounter/{encounter_id}/content', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sdp.suki.ai/api/v1/ambient/encounter/{encounter_id}/content",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"sdp_suki_token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://sdp.suki.ai/api/v1/ambient/encounter/{encounter_id}/content"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("sdp_suki_token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://sdp.suki.ai/api/v1/ambient/encounter/{encounter_id}/content")
.header("sdp_suki_token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://sdp.suki.ai/api/v1/ambient/encounter/{encounter_id}/content")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["sdp_suki_token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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"
}
]
}{
"code": 400,
"message": "invalid request"
}{
"code": 401,
"message": "invalid token"
}{
"code": 500,
"message": "internal server error"
}Updated:You can now get the Medication orders for an encounter from the encounter content response. Read more in Medication orders.
Code examples
- Python
- TypeScript
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())
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.
Authorizations
Headers
Path Parameters
Last modified on October 22, 2026
Was this page helpful?
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>'import requests
url = "https://sdp.suki.ai/api/v1/ambient/encounter/{encounter_id}/content"
headers = {"sdp_suki_token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {sdp_suki_token: '<api-key>'}};
fetch('https://sdp.suki.ai/api/v1/ambient/encounter/{encounter_id}/content', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sdp.suki.ai/api/v1/ambient/encounter/{encounter_id}/content",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"sdp_suki_token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://sdp.suki.ai/api/v1/ambient/encounter/{encounter_id}/content"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("sdp_suki_token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://sdp.suki.ai/api/v1/ambient/encounter/{encounter_id}/content")
.header("sdp_suki_token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://sdp.suki.ai/api/v1/ambient/encounter/{encounter_id}/content")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["sdp_suki_token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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"
}
]
}{
"code": 400,
"message": "invalid request"
}{
"code": 401,
"message": "invalid token"
}{
"code": 500,
"message": "internal server error"
}