---
title: "List templates"
method: GET
path: "/templates"
tags: ["templates"]
---

# List templates

`GET /templates`

Returns a list of templates. Review authentication, request parameters, response fields, and errors for this Runpod API operation.

## Query parameters

- `includeEndpointBoundTemplates` boolean — Include templates bound to Serverless endpoints in the response.
- `includePublicTemplates` boolean — Include community-made public templates in the response.
- `includeRunpodTemplates` boolean — Include official Runpod templates in the response.

## Response `200`

Successful operation.

- Template[]
  - `category` string — The category of the template. The category can be used to filter templates in the Runpod UI. Current categories are NVIDIA, AMD, and CPU.
  - `containerDiskInGb` integer — The amount of disk space, in gigabytes (GB), to allocate on the container disk for a Pod or worker. The data on the container disk is wiped when the Pod or worker restarts. To persist data across restarts, set volumeInGb to configure the local network volume.
  - `containerRegistryAuthId` string
  - `dockerEntrypoint` string[] — If specified, overrides the ENTRYPOINT for the Docker image run on a Pod or worker. If [], uses the ENTRYPOINT defined in the image.
  - `dockerStartCmd` string[] — If specified, overrides the start CMD for the Docker image run on a Pod or worker. If [], uses the start CMD defined in the image.
  - `earned` number — The amount of Runpod credits earned by the creator of a template by all Pods or workers created from the template.
  - `env` object
  - `id` string — A unique string identifying a template.
  - `imageName` string — The image tag for the container run on Pods or workers created from a template.
  - `isPublic` boolean — Set to true if a template is public and can be used by any Runpod user. Set to false if a template is private and can only be used by the creator.
  - `isRunpod` boolean — If true, a template is an official template managed by Runpod.
  - `isServerless` boolean — If true, instances created from a template are Serverless workers. If false, instances created from a template are Pods.
  - `name` string — A user-defined name for a template. The name needs to be unique.
  - `ports` string[] — A list of ports exposed on a Pod or worker. Each port is formatted as [port number]/[protocol]. Protocol can be either http or tcp.
  - `readme` string — A string of markdown-formatted text that describes a template. The readme is displayed in the Runpod UI when a user selects the template.
  - `runtimeInMin` integer
  - `volumeInGb` integer — The amount of disk space, in gigabytes (GB), to allocate on the local network volume for a Pod or worker. The data on the local network volume is persisted across restarts. To persist data so that future Pods and workers can access it, create a network volume and set networkVolumeId to attach it to the Pod or worker.
  - `volumeMountPath` string — If a local network volume or network volume is attached to a Pod or worker, the absolute path where the network volume is mounted in the filesystem.

## Other responses

- `400` — Invalid ID supplied.
- `404` — Template not found.

---

[API](https://skmtc.dev/runpod/apis/runpod-rest-api.md) · [All operations](https://skmtc.dev/runpod/apis/runpod-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runpod/runpod-rest-api/revisions/504cd0394ed6/schema)