---
title: "List available avatars"
method: GET
path: "/api/v1/avatars"
tags: ["cms"]
---

# List available avatars

`GET /api/v1/avatars`

## Query parameters

- `ids` string[], nullable
- `page` number
- `limit` number
- `order` object
- `gender` 'male' | 'female'
- `age` 'young' | 'middle-aged' | 'senior'
- `reusable` boolean
- `sagaId` string

## Response `201`

- AvatarsFindResponseDTO
  - `data` object[], required
    - `age` integer, required
    - `alt` string, nullable
    - `createdAt` string, required
    - `filename` string, required
    - `filesize` number, required
    - `gender` 'male' | 'female', required
    - `height` number, required
    - `id` string, required
    - `mimeType` string, required
    - `reusable` boolean, required
    - `sizes` object
      - `card` object
        - `url` string, nullable
      - `thumbnail` object
        - `url` string, nullable
    - `updatedAt` string, required
    - `url` string, required
    - `width` number, required
  - `meta` object, required
    - `hasNext` boolean, required
    - `limit` number, required
    - `page` number, required
    - `total` number, required

---

[API](https://skmtc.net/wejam/apis/jam.md) · [All operations](https://skmtc.net/wejam/apis/jam/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wejam/jam/revisions/bd5a5f406bca/schema)