---
title: "List template videos"
method: GET
path: "/v2/template_videos"
tags: ["Video"]
---

# List template videos

`GET /v2/template_videos`

## Request

- Base URL: `https://api.jogg.ai`
- URL: `https://api.jogg.ai/v2/template_videos`
- Auth: API key in header `x-api-key`

Get paginated list of template videos with optional filtering and sorting.

## Query parameters

- `page` integer
- `page_size` integer
- `status` 3 | 4 | 5
- `sort_by` string
- `sort_order` 'asc' | 'desc'

## 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
    - `data` object[]: List of template videos
      - `video_id` string: Video ID
      - `video_name` string: Video name
      - `status` 'processing' | 'completed' | 'failed': Video generation status
      - `created_at` integer: Creation timestamp
      - `cover_url` string, uri: Cover image URL
      - `url` string, uri: Video URL
      - `duration_seconds` number: Video duration in seconds
      - `error` object: Error information (only present when status is failed)
        - `code` string: Error code
        - `message` string: Error message
    - `pagination` Pagination: Pagination information
      - `page` integer: Current page number
      - `page_size` integer: Items per page
      - `total_items` integer: Total number of items
      - `total_pages` integer: Total number of pages

## Changes

- **2026-11-03** `22021dd81934`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/jogg/apis/joggai-openapi-v2/changes/v2/template_videos/get.md)

---

[API](https://skmtc.dev/jogg/apis/joggai-openapi-v2.md) - [All operations](https://skmtc.dev/jogg/apis/joggai-openapi-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/jogg/apis/joggai-openapi-v2/revisions/22021dd81934?raw)