> ## 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 Look

> Retrieve details of a specific look for an avatar

## Overview

This endpoint retrieves details for a specific look of an avatar. Use this to get full information about a particular look including available models and generation status.

## 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.
</ParamField>

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

## Response

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

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

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

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

<ResponseField name="gender" type="string">
  Gender of the avatar: `male` or `female`.
</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="place" type="string">
  Place or context of the look (e.g., "studio", "office").
</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 image.
</ResponseField>

<ResponseField name="preview" type="string">
  Preview URL if available, otherwise `null`.
</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>

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

<ResponseField name="error_message" type="string">
  Error message if status is `error`.
</ResponseField>

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

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

  url = "https://app.hoox.video/api/public/v1/avatar/avtr_abc123/look/look_123"
  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/look/look_123', {
    headers: {
      'Authorization': 'Bearer your_api_key'
    }
  });
  const data = await response.json();
  console.log(data);
  ```
</RequestExample>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "id": "look_123",
    "avatar_id": "avtr_abc123",
    "avatar_name": "Alex",
    "look_name": "Office Look",
    "gender": "male",
    "age_range": "adult",
    "ethnicity": "white-western-european",
    "hair_color": "brown",
    "place": "office",
    "accessories": ["laptop"],
    "action": "working",
    "emotion": "focused",
    "selfie": false,
    "format": "vertical",
    "thumbnail": "https://cdn.example.com/thumbnail.jpg",
    "preview": null,
    "model_available": ["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"],
    "status": "ready",
    "error_message": null
  }
  ```

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

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