> ## Documentation Index
> Fetch the complete documentation index at: https://docs.novita.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Template

You can list the sandbox templates available to you either from the CLI or programmatically through the SDK. The SDK returns each template's ID, aliases or names, resource sizing, visibility, and build metadata.

## Examples

```bash CLI icon="terminal" theme={"system"}
# Pretty table (default); alias: template ls
novita template list

# JSON output
novita template list --output json

# Scope to a team
novita template list --team <teamID>
```

```js JavaScript & TypeScript icon="js" theme={"system"}
import { Novita } from 'novita-sandbox'

const novita = new Novita()
const paginator = novita.template.list({
  templateType: 'template_build', // or 'snapshot_template'
  page: 1,
  limit: 20,
})

const page = await paginator.nextPage()
console.log(`total: ${page.total}, pages: ${page.totalPages}`)
for (const t of page.templates) {
  console.log(t.templateId, t.aliases, t.cpuCount, t.memoryMB, t.public)
}
```

```python Python icon="python" theme={"system"}
from novita_sandbox import Novita

novita = Novita()
res = novita.template.list(
    template_type="template_build",  # or "snapshot_template"
    page=1,
    limit=20,
)

print(f"total: {res.total}, pages: {res.total_pages}")
for t in res.items:
    print(t.template_id, t.aliases, t.cpu_count, t.memory_mb, t.public)
```

## Response

The response is paginated. The top-level fields are:

| Field | Type | Description |
| - | - | - |
| `templates` | TemplateInfo\[] | The templates on this page |
| `total` | number | Total number of templates |
| `page` | number | Current page number |
| `limit` | number | Items per page |
| `totalPages` | number | Total number of pages |

Each entry in `templates` includes:

| Field (JS / Python) | Type | Description |
| - | - | - |
| `templateId` / `template_id` | string | Template ID |
| `aliases` / `names` | string\[] | Template aliases / names |
| `cpuCount` / `cpu_count` | number | vCPU count |
| `memoryMB` / `memory_mb` | number | Memory in MiB |
| `diskSizeMB` / `disk_size_mb` | number | Disk size in MiB |
| `envdVersion` / `envd_version` | string | Envd version |
| `public` | boolean | Whether the template is public |
| `buildId` / `build_id` | string | Latest build ID |
| `buildCount` / `build_count` | number | Number of builds |
| `createdAt` / `created_at` | Date | Creation time |
| `updatedAt` / `updated_at` | Date | Last update time |
| `lastSpawnedAt` / `last_spawned_at` | Date \| null | Last time a sandbox was spawned |
| `createdBy` / `created_by` | object \| null | Creator (`id`, `email`) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.