Supported Diagnosis Codes

GET

api

info

diagnosis

cURL

curl --request GET \
  --url https://sdp.suki.ai/api/v1/info/diagnosis \
  --header 'sdp_suki_token: <sdp_suki_token>' \
  --header 'sdp_provider_id: <sdp_provider_id>'

import requests

url = "https://sdp.suki.ai/api/v1/info/diagnosis"

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/info/diagnosis', 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/info/diagnosis",
  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/info/diagnosis"

	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/info/diagnosis")
  .header("sdp_suki_token", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sdp.suki.ai/api/v1/info/diagnosis")

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

{
  "diagnosis_code_types": [
    {
      "code_type": "ICD10"
    }
  ]
}

{
  "code": 401,
  "message": "invalid token"
}

{
  "code": 403,
  "message": "forbidden"
}

Updated:

HCC is now included as a supported diagnosis code type for ambient structured data output.
Send ICD10 or IMO codes in session context. Do not send HCC codes as input.
HCC categories are returned from the Ambient session structured data API when an ICD-10-CM diagnosis maps to a CMS-HCC model category.

For how ICD-10 and HCC differ, refer to Diagnosis codes FAQs.

Use this endpoint to get the list of supported code types, including HCC for ambient structured data output.

Code examples

Python
TypeScript

import requests

url = "https://sdp.suki-stage.com/api/v1/info/diagnosis"
headers = {
    "sdp_suki_token": "<sdp_suki_token>",
    "sdp_provider_id": "<sdp_provider_id>"
}

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

if response.status_code == 200:
    diagnosis_data = response.json()
    print("Supported Diagnosis Code Types:")
    for code_type in diagnosis_data.get("diagnosis_code_types", []):
        print(f"  {code_type.get('code_type')}")
else:
    print(f"Failed to get diagnosis codes: {response.status_code}")
    print(response.json())

const response = await fetch('https://sdp.suki-stage.com/api/v1/info/diagnosis', {
  headers: {
    'sdp_suki_token': '<sdp_suki_token>',
    'sdp_provider_id': '<sdp_provider_id>'
  }
});

if (response.ok) {
  const diagnosisData = await response.json();
  console.log('Supported Diagnosis Code Types:');
  diagnosisData.diagnosis_code_types?.forEach((codeType: any) => {
    console.log(`  ${codeType.code_type}`);
  });
} else {
  const error = await response.json();
  console.error(`Failed to get diagnosis codes: ${response.status}`, error);
}

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"

Response

Request succeeded.

Response body for the /info/diagnosis endpoint

diagnosis_code_types

object[]

Information about supported diagnosis code types

Show child attributes

Last modified on July 23, 2026

Supported LOINCs

Supported Medical Specialties

⌘I