Suki Medical Form Templates IDs

GET

api

info

suki-medical-form-templates

cURL

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

const options = {method: 'GET', headers: {sdp_suki_token: '<api-key>'}};

fetch('https://sdp.suki.ai/api/v1/info/suki-medical-form-templates', 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/suki-medical-form-templates",
  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/suki-medical-form-templates"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://sdp.suki.ai/api/v1/info/suki-medical-form-templates")

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

{
  "form_templates": [
    {
      "description": "Standard vitals collection template for adult patients.",
      "name": "Adult Vitals",
      "template_id": "019d4cdc-9319-7d81-ae2e-fd6de7f1b4f0",
      "type": "VITALS_ASSESSMENT",
      "schema": {
        "items": [
          {
            "code": "Q003",
            "id": "respiratory_pattern",
            "kind": "field",
            "options": [
              {
                "code": null,
                "display": "Regular"
              },
              {
                "code": null,
                "display": "Shallow"
              }
            ],
            "pattern": "",
            "question": "Respiratory Pattern / Effort",
            "type": "radio"
          }
        ]
      }
    }
  ]
}

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

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

Use this endpoint to get the list of Suki-defined Medical form template IDs available for Form filling sessions. Use each returned template_id as form_template_id when seeding static form-filling context. For partner-defined forms that are not in the Suki Medical form templates catalog, send a dynamic schema in session context instead. Refer to Dynamic Form filling.

Code examples

The code examples below use placeholders and the stage host sdp.suki-stage.com only as examples. For credentials, base URLs, where to run Python or TypeScript, CORS, and cURL, refer to Using code examples in your integration in the API Reference Guidelines.

Python
TypeScript

from typing import Any, TypedDict, cast

import requests

BASE_URL = "https://sdp.suki-stage.com"


class MedicalFormTemplate(TypedDict, total=False):
    description: str
    name: str
    schema: Any
    template_id: str
    type: str


class GetSukiFormTemplatesResponse(TypedDict):
    form_templates: list[MedicalFormTemplate]


class ApiHttpError(RuntimeError):
    """Wrong HTTP status; OpenAPI errors usually include JSON with message + code."""

    def __init__(self, status: int, url: str, detail: str) -> None:
        super().__init__(f"HTTP {status} {url}: {detail}")
        self.status = status
        self.url = url


def _get_expect_json_object(url: str, headers: dict[str, str], expect_status: int) -> dict[str, Any]:
    r = requests.get(url, headers=headers, timeout=60)
    if r.status_code == expect_status:
        data = r.json()
        if isinstance(data, dict):
            return data
        raise ApiHttpError(expect_status, url, "response JSON was not an object")

    detail = ""
    try:
        err = r.json()
        if isinstance(err, dict) and isinstance(err.get("message"), str):
            detail = err["message"]
    except ValueError:
        detail = (r.text or "")[:500]
    raise ApiHttpError(r.status_code, url, detail or "(no body)")


def get_suki_medical_form_templates(suki_token: str) -> GetSukiFormTemplatesResponse:
    """GET /api/v1/info/suki-medical-form-templates (sdp_suki_token header required). HTTP 200."""
    url = f"{BASE_URL}/api/v1/info/suki-medical-form-templates"
    data = _get_expect_json_object(url, {"sdp_suki_token": suki_token, "sdp_provider_id": "<sdp_provider_id>"}, 200)
    ft = data.get("form_templates")
    if not isinstance(ft, list):
        raise ValueError(f"{url}: 200 response missing form_templates array")
    return cast(GetSukiFormTemplatesResponse, {"form_templates": ft})


if __name__ == "__main__":
    try:
        out = get_suki_medical_form_templates("YOUR_SUKI_TOKEN")
        templates = out["form_templates"]
        print(len(templates))

        # Use template_id as form_template_id for static Form filling context.
        # Partner dynamic schemas are not returned by this endpoint.
        form_template_ids = [
            t["template_id"] for t in templates if isinstance(t.get("template_id"), str)
        ]
        print(form_template_ids[:3])
    except (ApiHttpError, ValueError) as e:
        print(e)

const BASE_URL = "https://sdp.suki-stage.com";

type MedicalFormTemplate = {
  description?: string;
  name?: string;
  schema?: unknown;
  template_id?: string;
  type?: string;
};

type GetSukiFormTemplatesResponse = {
  form_templates: MedicalFormTemplate[];
};

class ApiHttpError extends Error {
  status: number;
  url: string;
  constructor(status: number, url: string, detail: string) {
    super(`HTTP ${status} ${url}: ${detail}`);
    this.status = status;
    this.url = url;
  }
}

async function getExpectJsonObject(url: string, headers: Record<string, string>, expectStatus: number) {
  const res = await fetch(url, { method: "GET", headers });
  const text = await res.text();
  const json = text ? JSON.parse(text) : {};

  if (res.status !== expectStatus) {
    const msg = typeof (json as any)?.message === "string" ? (json as any).message : text?.slice(0, 500) || "(no body)";
    throw new ApiHttpError(res.status, url, msg);
  }
  if (json && typeof json === "object" && !Array.isArray(json)) return json as Record<string, unknown>;
  throw new ApiHttpError(res.status, url, "response JSON was not an object");
}

export async function getSukiMedicalFormTemplates(sukiToken: string): Promise<GetSukiFormTemplatesResponse> {
  const url = `${BASE_URL}/api/v1/info/suki-medical-form-templates`;
  const data = await getExpectJsonObject(url, { sdp_suki_token: sukiToken, sdp_provider_id: "<sdp_provider_id>" }, 200);
  const ft = data.form_templates;
  if (!Array.isArray(ft)) {
    throw new Error(`${url}: 200 response missing form_templates array`);
  }
  return { form_templates: ft as MedicalFormTemplate[] };
}

// Example usage
const out = await getSukiMedicalFormTemplates("YOUR_SUKI_TOKEN");
console.log(out.form_templates.length);

// Use template_id as form_template_id for static Form filling context.
// Partner dynamic schemas are not returned by this endpoint.
const formTemplateIds = out.form_templates
  .map((t) => t.template_id)
  .filter((id): id is string => typeof id === "string");
console.log(formTemplateIds.slice(0, 3));

If this endpoint returns an empty list, contact support.

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/suki-medical-form-templates endpoint

form_templates

object[]

List of Suki-defined Medical form templates

Show child attributes

Last modified on September 29, 2026

cURL

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

const options = {method: 'GET', headers: {sdp_suki_token: '<api-key>'}};

fetch('https://sdp.suki.ai/api/v1/info/suki-medical-form-templates', 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/suki-medical-form-templates",
  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/suki-medical-form-templates"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://sdp.suki.ai/api/v1/info/suki-medical-form-templates")

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

{
  "form_templates": [
    {
      "description": "Standard vitals collection template for adult patients.",
      "name": "Adult Vitals",
      "template_id": "019d4cdc-9319-7d81-ae2e-fd6de7f1b4f0",
      "type": "VITALS_ASSESSMENT",
      "schema": {
        "items": [
          {
            "code": "Q003",
            "id": "respiratory_pattern",
            "kind": "field",
            "options": [
              {
                "code": null,
                "display": "Regular"
              },
              {
                "code": null,
                "display": "Shallow"
              }
            ],
            "pattern": "",
            "question": "Respiratory Pattern / Effort",
            "type": "radio"
          }
        ]
      }
    }
  ]
}

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

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

Get Started

API References

Suki Medical Form Templates IDs

Code examples

Authorizations

Headers

Response

​Code examples

Authorizations

Headers

Response

Code examples