---
title: "New Endpoint"
method: GET
path: "/v1/product_avatar/public_avatar/query"
---

# New Endpoint

`GET /v1/product_avatar/public_avatar/query`

This is your first endpoint! Edit this page to start documenting your API.

## Query parameters

- `ethnicityIds` string
- `gender` 'male' | 'female'
- `sortingType` 'Popularity' | 'Newest'
- `categoryIds` string
- `pageNo` integer
- `pageSize` integer

## Response `200`

- object
  - `code` string, required — 200: success Other: fail
  - `message` string, required
  - `result` object
    - `avatarId` string
    - `avatarImagePath` string — URL of the avatar image.
    - `avatarImagePathWithoutProduct` string — URL of the avatar image without product.
    - `voiceoverId` string
    - `gender` 'male' | 'female'
    - `avatarCategoryList` object
      - `categoryId` string
      - `categoryName` string
    - `avatarEthnicityList` object
      - `ethnicityId` string
      - `ethnicityName` string
    - `minSubsType` 'free' | 'starter' — Minimum subscriptiontype required for theavatar.

---

[API](https://skmtc.net/topview/apis/image-character-swap-apis-editable-in-readme.md) · [All operations](https://skmtc.net/topview/apis/image-character-swap-apis-editable-in-readme/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topview/image-character-swap-apis-editable-in-readme/revisions/83cd46ca7859/schema)