---
title: "Get Suki Medical form templates"
method: GET
path: "/api/v1/info/suki-medical-form-templates"
tags: ["/api/v1/info"]
---

# Get Suki Medical form templates

`GET /api/v1/info/suki-medical-form-templates`

## Request

- Base URL: `https://sdp.suki.ai`
- URL: `https://sdp.suki.ai/api/v1/info/suki-medical-form-templates`
- Auth: API key in header `sdp_suki_token`

Lists Suki Medical form templates. Use each `template_id` as `form_template_id` for static Form filling context. For partner-defined forms, send a `schema` in context instead.

## Headers

- `sdp_provider_id` string

## Response `200`

Request succeeded.

- ControllersGetSukiFormTemplatesResponse: Response body for the /info/suki-medical-form-templates endpoint
  - `form_templates` ControllersMedicalFormTemplate[]: List of Suki-defined Medical form templates
    - `description` string: **Optional** - Free-text description
    - `name` string: Human-readable template name
    - `schema` ControllersMedicalFormTemplateSchema: Object describing the structure of a Medical form template, including its field definitions.
      - `items` ControllersMedicalFormTemplateSchemaItem[]: Ordered list of template fields and questions.
        - `code` string: Question or field code.
        - `id` string: Stable field identifier within the template.
        - `kind` string: Item kind (for example `field`).
        - `options` ControllersMedicalFormTemplateSchemaOption[]: **Optional** - Choices for selection-style fields (for example `radio`).
          - `code` string, nullable: **Optional** - Option code when provided; may be null for display-only choices.
          - `display` string: Human-readable option label shown in the form UI.
        - `pattern` string: **Optional** - Validation pattern when applicable.
        - `question` string: Question or field label text.
        - `type` string: Input type (for example `radio`, `text`).
    - `template_id` string: Unique identifier for this template version
    - `type` string: Type classification (e.g., VITALS_ASSESSMENT, SKIN_ASSESSMENT)

## Other responses

- `401`: Unauthorized. The Suki access token is missing, expired, or invalid.
- `403`: Forbidden. The authenticated user cannot access this resource.

---

[API](https://skmtc.dev/suki/apis/suki-developer-platform.md) - [All operations](https://skmtc.dev/suki/apis/suki-developer-platform/llms.txt) - [OpenAPI document](https://skmtc.dev/suki/apis/suki-developer-platform/revisions/2181be71d4dd?raw)
