---
title: "Get Avatars"
method: GET
path: "/avatar/"
tags: ["Avatars management"]
---

# Get Avatars

`GET /avatar/`

Endpoint to list all avatars available to the user.

## Query parameters

- `team_id` string, uuid

## Response `200`

Successful Response

- AvatarResponse[]
  - `id` string, uuid, required
  - `name` string, required
  - `frontal_user_image_url` string
  - `right_side_image_url` string
  - `left_side_user_image_url` string
  - `preview_image_url` string
  - `avatar_meta_image` string
  - `glb_model_url` string
  - `idle_animation_url` string
  - `dante_user_id` string, uuid
  - `external_user_id` string
  - `external_id` string
  - `external_session_url` string
  - `status` 'new' | 'created' | 'in_creation' | 'failed', required — An enumeration.
  - `hair` string, uuid
  - `hair_value` string
  - `clothes` string, uuid
  - `clothes_value` string
  - `gender` string
  - `hair_color` string
  - `eye_color` string
  - `remove_dante_logo` boolean
  - `age` string
  - `skin_tone` number
  - `kb_id` string, uuid
  - `voice_id` string, uuid
  - `llm_model_type` 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4-omnimodel-mini' | 'gpt-4-omnimodel' | 'gpt-4-omnimodel-128k' | 'gpt-4-turbo' | 'gpt-4-turbo-128k' | 'gpt-4' | 'gpt-4-32k' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo-16k' | 'falcon' | 'mistral' | 'wizardlm' | 'gemma' | 'llama2' | 'llama3' | 'llama3_8b' | 'cohere' | 'claude_3_opus_9k' | 'claude_3_opus_32k' | 'claude_3_opus_128k' | 'claude_3_opus_200k' | 'claude_3_sonnet' | 'claude_3_dot_5_sonnet' | 'claude_3_haiku' | 'claude_3_dot_7_sonnet' | 'claude_4_opus' | 'claude_4_sonnet' | 'gemini-2.0-flash' | 'gemini-2.5-flash' | 'gemini-2.0-flash-lite' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude_4_dot_5_sonnet' | 'claude_4_dot_1_opus' | 'claude_4_dot_5_haiku' | 'gemini-2.5-pro' | 'gemini-2.5-flash-lite' | 'gpt-5.1' | 'gemini-3-pro' | 'gpt-5.2' | 'gpt-5.4' | 'gemini-3-flash' | 'claude_4_dot_6_opus' | 'claude_4_6_sonnet' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'gpt-5.5' | 'gpt-5.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'claude_4_7_opus' | 'claude_4_8_opus' | 'claude_5_opus' | 'claude_5_sonnet' — An enumeration.
  - `base_system_prompt` string
  - `initial_messages` string[]
  - `prompt_suggestions` string[]
  - `show_prompt_messages` boolean
  - `open_to_internet_knowledge` boolean
  - `personalities_template` string
  - `light_customization` AvatarLightCustomization
    - `id` string, uuid
    - `date_created` string, date-time
    - `date_updated` string, date-time
    - `avatar_id` string
    - `preset_light` string
    - `light_direction` string
    - `ambient_light_color` string
    - `ambient_light_intensity` number
    - `background_color` string
    - `background_image` string
    - `point_light_color` string
    - `point_light_decay` number
    - `point_light_intensity` number
    - `spot_light_color` string
    - `spot_light_decay` number
    - `spot_light_intensity` number
    - `spot_light_penumbra` number
    - `spot_light_position_x` number
    - `spot_light_position_y` number
    - `spot_light_position_z` number

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/dante-ai/apis/dante-ai-api.md) · [All operations](https://skmtc.net/dante-ai/apis/dante-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dante-ai/dante-ai-api/versions/38b6c9a4246d/schema)