---
title: "List user's custom templates"
method: GET
path: "/v2/templates/custom"
tags: ["Template"]
---

# List user's custom templates

`GET /v2/templates/custom`

Retrieve a list of user's custom templates with optional filtering by aspect ratio.

## Query parameters

- `aspect_ratio` 'portrait' | 'landscape' | 'square'

## Response `200`

Success

- object
  - `code` integer, required — Business status code: * 0 - Success * 10104 - Record not found * 10105 - Invalid API key * 18020 - Insufficient credit * 18025 - No permission to call APIs * 40000 - Parameter error * 50000 - System error
  - `msg` string, required — Response message
  - `data` object
    - `templates` TemplateInfo[]
      - `id` integer — Template ID
      - `name` string — Template name
      - `cover_url` string — Template preview image
      - `preview_url` string — Template preview video
      - `aspect_ratio` 0 | 1 | 2 — Aspect ratio: * 0 - Portrait [9:16] * 1 - Landscape [16:9] * 2 - Square [1:1]

---

[API](https://skmtc.net/jogg/apis/joggai-openapi-v2.md) · [All operations](https://skmtc.net/jogg/apis/joggai-openapi-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jogg/joggai-openapi-v2/versions/ec8807ce9c12/schema)