---
title: "Get User Avatar"
method: GET
path: "/v3/users/{route_users_id}/avatar"
tags: ["User Avatar v3"]
---

# Get User Avatar

`GET /v3/users/{route_users_id}/avatar`

## Request

- Base URL: `https://api.sidequestvr.com`
- URL: `https://api.sidequestvr.com/v3/users/{route_users_id}/avatar`
- Auth: none declared

The user's resolved v3 avatar: every enabled catalog option with the value their level entitles them to, and the custom avatar once they have one and are at least the unlock level. Use GET /v3/avatars/catalog to know what each value means.

## Path parameters

- `route_users_id` string, required

## Response `200`

Success

- AvatarV3Model: A user's resolved v3 avatar: the built-in options their level entitles them to, plus the custom avatar once they reach level 50
  - `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.
- `404`: No resource was found at the target path or the authorization token provided does not have access to know that it exists.

## Changes

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

[Operation history](https://skmtc.dev/sidequestvr/apis/sidequest-api/changes/v3/users/:route_users_id/avatar/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)