---
title: "List product avatars"
method: GET
path: "/v2/avatars/product_avatars"
tags: ["Avatar"]
---

# List product avatars

`GET /v2/avatars/product_avatars`

## Request

- Base URL: `https://api.jogg.ai`
- URL: `https://api.jogg.ai/v2/avatars/product_avatars`
- Auth: API key in header `x-api-key`

Get list of user's product avatars with optional aspect ratio filter.
Supports filtering avatars by different aspect ratios for various video formats.

## Query parameters

- `aspect_ratio` 'portrait' | 'landscape'

## 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
    - `product_avatars` object[]: List of product avatars
      - `avatar_id` integer: Avatar ID
      - `name` string: Avatar name
      - `cover_url` string, uri: Cover URL
      - `status` 0 | 1 | 2: Avatar status
      - `fail_msg` string: Failure message (if failed)
      - `avatar_url` string, uri: Avatar URL
      - `aspect_ratio` 0 | 1 | 2: Aspect ratio
      - `gender` string: Gender

## Changes

- **2026-11-03** `22021dd81934`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/jogg/apis/joggai-openapi-v2/changes/v2/avatars/product_avatars/get.md)

---

[API](https://skmtc.dev/jogg/apis/joggai-openapi-v2.md) - [All operations](https://skmtc.dev/jogg/apis/joggai-openapi-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/jogg/apis/joggai-openapi-v2/revisions/22021dd81934?raw)