---
title: "List OS templates"
method: GET
path: "/api/v1/public/templates"
tags: ["Catalog"]
---

# List OS templates

`GET /api/v1/public/templates`

Returns all public OS templates available for VM creation.
Windows templates are only available for premium VM types.

## Query parameters

- `category` 'os' | 'marketplace'
- `vm_type` 'standard' | 'premium' | 'windows'
- `region` 'us-east'

## Response `200`

List of templates

- object
  - `success` boolean
  - `data` Template[]
    - `id` string, uuid, required — Template ID — use as `template_id` when creating a VM
    - `name` string, required — OS name
    - `version` string, required — OS version
    - `cpu` integer, required — Minimum vCPU cores required
    - `ram` integer, required — Minimum RAM in GB required
    - `storage` integer, required — Minimum storage in GB required
    - `is_windows` boolean, required — Whether this is a Windows template (only available for premium VMs)
    - `os_type` string, required — Operating system type
    - `category` 'os' | 'marketplace', required — Template category
    - `description` string — Template description
    - `region` 'us-east', required — Region where this template is available
  - `total` integer — Total number of templates returned

## Other responses

- `400` — Invalid request parameters

## Changes

- **2026-08-20** `efd3c11c5c92` — 1 info
  - added the new enum value `windows` to the `query` request parameter `vm_type`
- **2026-05-06** `9e13a6e23934` — 10 info
  - the response property `data/items/category` became required for the status `200`
  - the response property `data/items/cpu` became required for the status `200`
  - the response property `data/items/id` became required for the status `200`
  - the response property `data/items/is_windows` became required for the status `200`
  - …6 more
- **2026-03-20** `51e2355a0abe` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rafftechnologies/apis/raff-api/changes/api/v1/public/templates/get.md)

---

[API](https://skmtc.dev/rafftechnologies/apis/raff-api.md) · [All operations](https://skmtc.dev/rafftechnologies/apis/raff-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rafftechnologies/raff-api/revisions/2f4df56be77c/schema)