Suki APIs

Suki provides partner APIs that let you integrate Suki’s ambient clinical intelligence into your applications.

Introduction

Suki APIs use REST for API requests, Suki access tokens for authentication, and WebSockets for real-time audio streaming. The APIs return standard HTTP status codes and JSON response bodies. You can explore and test the APIs using the OpenAPI bundle. Access requires partner onboarding.

Use the APIs to capture clinical conversations, stream live audio, retrieve structured output, and receive webhook events while your application owns the UI and downstream integrations.

How it works

Use REST endpoints: Create sessions, send context, end sessions, and retrieve results from the API reference.
Add streaming when needed: Use WebSocket flows when a workflow needs live audio. Send the correct session context for that workflow.
Receive asynchronous notifications: Configure webhooks when you want completion and status events sent to your backend.

Authentication

Suki APIs are available only to approved partners. Complete Partner onboarding before you use them. Authentication has two layers:

Partner authentication: Your application sends a JWT from your identity provider (partner token). Suki validates it against your registered keys so traffic is tied to your organization.
Provider authentication: Register each clinician once, then sign them in for a Suki access token for REST, WebSocket, and related calls.

Get Started Authentication

Download OpenAPI description

Overview

Base URL

https://sdp.suki.ai/

API support

support@suki.ai

API guidelines

Languages

curl -X POST https://sdp.suki.ai/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "partner_id": "your-partner-id",
    "partner_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
    "provider_id": "provider-123"
  }'

const response = await fetch("https://sdp.suki.ai/api/v1/auth/login", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    partner_id: "your-partner-id",
    partner_token: "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
    provider_id: "provider-123", // Optional
  }),
});

if (response.ok) {
  const data = await response.json();
  const sukiToken = data.suki_token;
  console.log(`Authentication successful. Token: ${sukiToken}`);
} else {
  const error = await response.json();
  console.error(`Authentication failed: ${response.status}`, error);
}

import requests

url = "https://sdp.suki.ai/api/v1/auth/login"

payload = {
    "partner_id": "your-partner-id",
    "partner_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
    "provider_id": "provider-123"  # Optional
}

response = requests.post(url, json=payload)

if response.status_code == 200:
    data = response.json()
    suki_token = data["suki_token"]
    print(f"Authentication successful. Token: {suki_token}")
else:
    print(f"Authentication failed: {response.status_code}")
    print(response.json())

require "net/http"
require "json"

uri = URI("https://sdp.suki.ai/api/v1/auth/login")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Post.new(uri)
req["Content-Type"] = "application/json"
req.body = JSON.generate(
  "partner_id" => "your-partner-id",
  "partner_token" => "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "provider_id" => "provider-123"
)

res = http.request(req)
puts res.body

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class LoginExample {
  public static void main(String[] args) throws Exception {
    String body =
        "{"
            + "\"partner_id\":\"your-partner-id\","
            + "\"partner_token\":\"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...\","
            + "\"provider_id\":\"provider-123\""
            + "}";
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request =
        HttpRequest.newBuilder()
            .uri(URI.create("https://sdp.suki.ai/api/v1/auth/login"))
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(body))
            .build();
    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  }
}

<?php

$ch = curl_init("https://sdp.suki.ai/api/v1/auth/login");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt(
    $ch,
    CURLOPT_POSTFIELDS,
    json_encode([
        "partner_id" => "your-partner-id",
        "partner_token" => "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
        "provider_id" => "provider-123",
    ])
);

$response = curl_exec($ch);
curl_close($ch);
echo $response;

Servers

Production host URL

https://sdp.suki.ai

Current API version

https://sdp.suki.ai/api/v1

Confirm with your Suki partnership team for production URLs, and any host-specific routing before you go live.

Choose your API Workflow

Available APIs

Pick the APIs for your use case and workflow and start building your integration.

Decide Your Workflow

Start building

Ambient API IntroductionLearn more about the Ambient API and how to get started.Webhooks IntroductionLearn more about the Webhooks to receive notifications from Suki.Ambient API QuickstartBuild your first ambient session and stream audio in minutes.WebSocket APIsStream visit audio over WebSocket for ambient and form filling sessions.Form Filling API IntroductionLearn more about the Form Filling API and how to get started.API GuidelinesLearn more about the API guidelines to help you build your integration.Form Filling API QuickstartBuild your first form-filling session and retrieve structured data in minutes.Partner OnboardingLearn more about the partner onboarding process to start using the Suki APIs.

Stay updated

Learn about the latest updates to the Ambient, Form Filling, and Dictation APIs.

Ambient & Dictation APIs Changelog

New endpoints, deprecations, and behavior notes for Ambient, and Dictation APIs.

Form Filling APIs Changelog

New endpoints, deprecations, and behavior notes for Form Filling APIs.

Suki APIs

Introduction

How it works

Authentication

Download OpenAPI description

Overview

Languages

Servers

Available APIs

Ambient APIs

Form Filling APIs

Dictation APIs

Start building

Stay updated

Ambient & Dictation APIs Changelog

Form Filling APIs Changelog