---
title: "Get Avatars (batch)"
method: GET
path: "/v3/avatars"
tags: ["Avatars v3"]
---

# Get Avatars (batch)

`GET /v3/avatars`

## Request

- Base URL: `https://api.sidequestvr.com`
- URL: `https://api.sidequestvr.com/v3/avatars`
- Auth: none declared

Resolved v3 avatars for up to 100 users at once, for rooms and lists. Ids that do not belong to a user are omitted from the result rather than erroring.

## Query parameters

- `users_ids` string

## Response `200`

Success

- AvatarV3Model[]
  - `users_id` integer, required: The users_id this avatar belongs to
  - `level` integer, required: The user's current level, derived from their XP. Options above this level fall back to their defaults.
  - `options` object, required: Map of option_key to the selected value, e.g. {"base":"robot"}. Every enabled catalog option with a default is present; options with no default are present only when chosen.
  - `custom_avatar` AvatarCustomV3Model: The level-50 custom avatar attached to a user's v3 avatar
    - `files_id` integer, required: The files_id of the uploaded avatar file
    - `url` string, required: The absolute CDN URL the client loads the avatar from
    - `type` string, required: The file extension of the avatar file, e.g. glb

## Other responses

- `400`: The data provided to the call was incorrect or incomplete.

## Changes

- **2026-10-12** `5f62fe19531f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sidequestvr/apis/sidequest-api/changes/v3/avatars/get.md)

---

[API](https://skmtc.dev/sidequestvr/apis/sidequest-api.md) - [All operations](https://skmtc.dev/sidequestvr/apis/sidequest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sidequestvr/apis/sidequest-api/revisions/015df326911c?raw)