Supported Medical Specialties

Get list of supported medical specialties and their identifiers

GET /api/v1/info/specialties

Gets the list of supported medical specialties.

cURL

curl --request GET \
  --url https://sdp.suki-stage.com/api/v1/info/specialties \
  --header 'sdp_suki_token: <sdp_suki_token>'

200

{
  "specialties": [
    {
      "code": "CARDIOLOGY"
    }
  ]
}

Use this endpoint to get the list of supported medical specialties. This list is used to validate the specialty field in the session context when creating or updating an ambient session.

For more information about the specialties, refer to the Medical specialties section.

Code examples

Python

import requests

url = "https://sdp.suki.ai/api/v1/info/specialties"
headers = {
    "sdp_suki_token": "<sdp_suki_token>"
}

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

if response.status_code == 200:
    specialties_data = response.json()
    print("Supported Medical Specialties:")
    for specialty in specialties_data.get("specialties", []):
        print(f"  {specialty.get('code')}")
else:
    print(f"Failed to get specialties: {response.status_code}")
    print(response.json())

TypeScript

const response = await fetch('https://sdp.suki.ai/api/v1/info/specialties', {
  headers: {
    'sdp_suki_token': '<sdp_suki_token>'
  }
});

if (response.ok) {
  const specialtiesData = await response.json();
  console.log('Supported Medical Specialties:');
  specialtiesData.specialties?.forEach((specialty: any) => {
    console.log(`  ${specialty.code}`);
  });
} else {
  const error = await response.json();
  console.error(`Failed to get specialties: ${response.status}`, error);
}

Headers

sdp_suki_token · string · required

sdp_suki_token

Response

200

*/*

Success Response

Response body for the /info/specialties endpoint

specialties · object[]

Information about supported specialties

Show child attributes