---
title: "Get Avatar By Id"
method: GET
path: "/v1/avatars/{avatar_id}"
tags: ["Avatar"]
---

# Get Avatar By Id

`GET /v1/avatars/{avatar_id}`

Get avatar by id

## Path parameters

- `avatar_id` string, required

## Cookies

- `la_session` string

## Response `200`

Successful Response

- ResponseAvatarSchema
  - `code` integer
  - `data` AvatarSchema
    - `id` string, uuid, required
    - `space_id` string
    - `type` 'IMAGE' | 'VIDEO'
    - `status` 'ACTIVE' | 'INIT' | 'DEPLOYING' | 'FAILED'
    - `name` string, required
    - `preview_url` string
    - `is_expired` boolean
    - `default_voice` DefaultAvatarVoice
      - `id` string, required
      - `name` string, required
    - `is_1080p` boolean
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `error_message` string, required — Error message if training failed (prefer detailed, fallback to short).
  - `message` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/liveavatar/apis/live-avatar-api.md) · [All operations](https://skmtc.net/liveavatar/apis/live-avatar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liveavatar/live-avatar-api/versions/fbfa5cdbd7f9/schema)