---
title: "search templates"
method: GET
path: "/api/v0/template/"
tags: ["Search"]
---

# search templates

`GET /api/v0/template/`

Searches for templates using filter-based queries.

Use `select_filters` to search by specific field conditions. Results include both your own templates and publicly shared templates.

**Available filter fields:** `creator_id`, `created_at`, `count_created`, `default_tag`, `docker_login_repo`, `id`, `image`, `jup_direct`, `hash_id`, `name`, `recent_create_date`, `recommended_disk_space`, `recommended`, `ssh_direct`, `tag`, `use_ssh`

**Operators:** `eq`, `neq`, `lt`, `lte`, `gt`, `gte`, `in`, `notin`

For detailed usage, see [Creating and Using Templates with API](/api-reference/creating-and-using-templates-with-api).

CLI Usage: `vastai search templates`

## Query parameters

- `select_filters` string
- `select_cols` string
- `order_by` string

## Response `200`

Successfully retrieved templates

- object
  - `success` boolean, required
  - `templates_found` integer, required — Number of templates found.
  - `templates` Template[], required — List of templates matching the search criteria.
    - `id` integer — Template ID
    - `name` string — Template name
    - `image` string — Docker image name

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Too Many Requests

---

[API](https://skmtc.net/vast/apis/vast-ai-api.md) · [All operations](https://skmtc.net/vast/apis/vast-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vast/vast-ai-api/revisions/4ed14f79f796/schema)