---
title: "Retrieve talking avatar video"
method: GET
path: "/v2/avatar_video/{id}"
tags: ["Video"]
---

# Retrieve talking avatar video

`GET /v2/avatar_video/{id}`

Get video information and status by video ID

## Path parameters

- `id` string, required

## 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
    - `video_id` string — Unique video identifier
    - `status` 'pending' | 'processing' | 'completed' | 'failed' — Video processing status
    - `video_url` string, uri — Video file URL (available when status is completed)
    - `cover_url` string, uri — Video cover image URL (available when status is completed)
    - `created_at` integer — Video creation timestamp (Unix timestamp)

---

[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)