---
title: "Get Public Avatar List"
method: GET
path: "/v2/avatars/public"
tags: ["Avatar"]
---

# Get Public Avatar List

`GET /v2/avatars/public`

Retrieve list of public avatars with filtering options.
Supports pagination and various filters including aspect ratio, style, gender, age, scene, and ethnicity.

## Query parameters

- `page` integer
- `page_size` integer
- `aspect_ratio` 'portrait' | 'landscape' | 'square'
- `style` 'professional' | 'social'
- `gender` 'female' | 'male'
- `age` 'adult' | 'senior' | 'young_adult'
- `scene` 'lifestyle' | 'outdoors' | 'business' | 'studio' | 'health_fitness' | 'education' | 'news'
- `ethnicity` 'european' | 'african' | 'south_asian' | 'east_asian' | 'middle_eastern' | 'south_american' | 'north_american'

## 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
    - `avatars` object[] — List of public avatars
      - `id` integer — Avatar ID
      - `name` string — Avatar name
      - `video_url` string, uri — Video URL
      - `cover_url` string, uri — Cover URL
      - `aspect_ratio` 0 | 1 | 2 — Aspect ratio
      - `style` 'professional' | 'social' — Style
      - `gender` 'female' | 'male' — Gender
      - `age` 'adult' | 'senior' | 'young_adult' — Age

---

[API](https://skmtc.net/jogg/apis/joggai-openapi-v2.md) · [All operations](https://skmtc.net/jogg/apis/joggai-openapi-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jogg/joggai-openapi-v2/versions/ec8807ce9c12/schema)