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

---

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