> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hoox.video/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Avatar

> Retrieve details of a specific avatar by its ID

## Overview

This endpoint retrieves details for a specific avatar by its `id`. Results can come from your space (custom avatars) or from the public catalog. The response includes all looks associated with the avatar.

## Authentication

<Info>
  This endpoint requires API key authentication. Include your API key in the `Authorization` header.
</Info>

## Path Parameters

<ParamField path="avatar_id" type="string" required>
  The unique identifier of the avatar to retrieve.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Unique identifier of the avatar.
</ResponseField>

<ResponseField name="name" type="string">
  Name of the avatar.
</ResponseField>

<ResponseField name="gender" type="string">
  Gender of the avatar: `male` or `female`.
</ResponseField>

<ResponseField name="age" type="string">
  Age of the avatar.
</ResponseField>

<ResponseField name="age_range" type="string">
  Avatar age range.
</ResponseField>

<ResponseField name="ethnicity" type="string">
  Avatar ethnicity.
</ResponseField>

<ResponseField name="hair_color" type="string">
  Avatar hair color.
</ResponseField>

<ResponseField name="thumbnail" type="string">
  URL of the avatar thumbnail image.
</ResponseField>

<ResponseField name="looks" type="array">
  Array of looks associated with this avatar.

  <Expandable title="Look object properties">
    <ResponseField name="id" type="string">
      Unique identifier of the look.
    </ResponseField>

    <ResponseField name="name" type="string">
      Name of the look.
    </ResponseField>

    <ResponseField name="place" type="string">
      Place or context of the look.
    </ResponseField>

    <ResponseField name="accessories" type="array">
      Visible accessories or props in the look.
    </ResponseField>

    <ResponseField name="action" type="string">
      Main action detected for the look.
    </ResponseField>

    <ResponseField name="emotion" type="string">
      Emotion or mood detected for the look.
    </ResponseField>

    <ResponseField name="selfie" type="boolean">
      Whether the look is a selfie-style shot.
    </ResponseField>

    <ResponseField name="format" type="string">
      Image format: `vertical` or `horizontal`.
    </ResponseField>

    <ResponseField name="thumbnail" type="string">
      URL of the look thumbnail.
    </ResponseField>

    <ResponseField name="preview" type="string">
      Preview URL if available, otherwise `null`.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current status: `ready`, `pending`, or `error`.
    </ResponseField>

    <ResponseField name="model_available" type="array">
      Available models for this look. Possible values: `standard`, `premium`, `ultra`, `veo-3-fast`, `veo-3`, `veo-3-lite`, `omni-flash`, `ora-lite`, `ora-standard`, `ora-pro`, `seedance-2`, `seedance-2-fast`, `seedance-2-1080p`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="created_at" type="string">
  Creation timestamp if available, otherwise `null`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://app.hoox.video/api/public/v1/avatar/avtr_abc123" \
    -H "Authorization: Bearer your_api_key"
  ```

  ```python Python theme={null}
  import requests

  url = "https://app.hoox.video/api/public/v1/avatar/avtr_abc123"
  headers = {"Authorization": "Bearer your_api_key"}
  response = requests.get(url, headers=headers)
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://app.hoox.video/api/public/v1/avatar/avtr_abc123', {
    headers: {
      'Authorization': 'Bearer your_api_key'
    }
  });
  const data = await response.json();
  console.log(data);
  ```
</RequestExample>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "id": "avtr_abc123",
    "name": "Alex",
    "gender": "male",
    "age": "30",
    "age_range": "adult",
    "ethnicity": "white-western-european",
    "hair_color": "brown",
    "thumbnail": "https://cdn.example.com/avatar-thumbnail.jpg",
    "looks": [
      {
        "id": "look_123",
        "name": "Office Look",
        "place": "office",
        "accessories": ["laptop"],
        "action": "working",
        "emotion": "focused",
        "selfie": false,
        "format": "vertical",
        "thumbnail": "https://cdn.example.com/look-thumbnail.jpg",
        "preview": null,
        "status": "ready",
        "model_available": ["premium", "ultra", "veo-3", "veo-3-fast", "veo-3-lite", "omni-flash", "ora-lite", "ora-standard", "ora-pro", "seedance-2", "seedance-2-fast", "seedance-2-1080p"]
      },
      {
        "id": "look_456",
        "name": "Studio Look",
        "place": "studio",
        "accessories": ["microphone"],
        "action": "presenting",
        "emotion": "confident",
        "selfie": false,
        "format": "vertical",
        "thumbnail": "https://cdn.example.com/look2-thumbnail.jpg",
        "preview": null,
        "status": "ready",
        "model_available": ["premium", "ultra", "veo-3", "veo-3-fast", "veo-3-lite", "omni-flash", "ora-lite", "ora-standard", "ora-pro", "seedance-2", "seedance-2-fast", "seedance-2-1080p"]
      }
    ],
    "created_at": "2024-01-15T10:30:00Z"
  }
  ```

  ```json Error 404 - Not Found theme={null}
  {
    "error": "Avatar not found",
    "details": [
      {
        "code": "NOT_FOUND",
        "message": "Avatar with id \"avtr_abc123\" not found"
      }
    ]
  }
  ```
</ResponseExample>