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

# List templates

`GET /api/v1/templates`

## Request

- Base URL: `https://api.gemina.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gemina.co/api/v1/templates`
- Auth: OAuth 2 (password, token URL `token`)

List all templates for the authenticated user.

## Query parameters

- `skip` integer
- `limit` integer
- `is_active` boolean, nullable: Filter by active status

## Response `200`

Successful Response

- TemplateListOutDTO
  - `count` integer, required
  - `templates` TemplateOutDTO[], required
    - `id` string, uuid, required
    - `name` string, required
    - `description` string, nullable, required
    - `schema` TemplateSchemaDTOOutput
      - `fields` object
      - `tables` object
    - `status` 'PENDING' | 'PROCESSING' | 'READY' | 'FAILED', required
    - `error` string, nullable
    - `sourceFilename` string, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, nullable
    - `isActive` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gemina/apis/gemina-api.md) · [All operations](https://skmtc.dev/gemina/apis/gemina-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gemina/apis/gemina-api/revisions/152fd3f6f6ec?raw)