---
title: "Returns details about the authenticated user's avatar."
method: GET
path: "/v1/avatar"
tags: ["Avatars"]
---

# Returns details about the authenticated user's avatar.

`GET /v1/avatar`

## Headers

- `Roblox-Place-Id` integer

## Response `200`

OK

- RobloxApiAvatarModelsAvatarModelV2 — A model containing details about an avatar
  - `scales` RobloxWebResponsesAvatarScaleModel
    - `height` number, double
    - `width` number, double
    - `head` number, double
    - `depth` number, double
    - `proportion` number, double
    - `bodyType` number, double
  - `playerAvatarType` 1 | 3 — The avatar type
  - `bodyColors` RobloxApiAvatarModelsBodyColorsModel — A model container BrickColor ids for each body part.
    - `headColorId` integer — The BrickColor id for head color
    - `torsoColorId` integer — The BrickColor id for torso color
    - `rightArmColorId` integer — The BrickColor id for right arm color
    - `leftArmColorId` integer — The BrickColor id for left arm color
    - `rightLegColorId` integer — The BrickColor id for right leg color
    - `leftLegColorId` integer — The BrickColor id for left leg color
  - `assets` RobloxApiAvatarModelsAssetModelV2[] — The assets worn on the character
    - `id` integer — The id
    - `name` string — The name
    - `assetType` RobloxApiAvatarModelsAssetTypeModel — A model containing details about an asset type
      - `id` integer — The id
      - `name` string — The name
    - `currentVersionId` integer — Id of the current version of asset
    - `meta` RobloxApiAvatarModelsAssetMetaModelV1 — Exhaustive model denoting all possible metadata fields of an asset
      - `order` integer — Layered-clothing order
      - `puffiness` number, float — Layered-clothing puffiness
      - `position` RobloxApiAvatarModelsAssetPosition — A model which contains accessory position coordinates.
        - `X` number, float — X coordinate of the position.
        - `Y` number, float — y coordinate of the position.
        - `Z` number, float — Z coordinate of the position.
      - `rotation` RobloxApiAvatarModelsAssetRotation — A model which contains accessory rotation coordinates.
        - `X` number, float — X degrees of the rotation.
        - `Y` number, float — Y degrees of the rotation.
        - `Z` number, float — Z degrees of the rotation.
      - `scale` RobloxApiAvatarModelsAssetScale — A model which contains accessory scale.
        - `X` number, float — X scale multiplier of accessory.
        - `Y` number, float — Y scale multiplier of accessory.
        - `Z` number, float — Z scale multiplier of accessory.
      - `headShape` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 — Head Shape selected for the asset id. Applicable for dynamic head assets.
      - `staticFacialAnimation` boolean — Indicates user choice for facial animation. staticFacialAnimation=false, implies the toggle as on and face will animate. Applicable for dynamic head assets.
      - `version` integer — Client-authoritative meta model format version - default is always 1
    - `availabilityStatus` string — Asset availability status.
    - `expirationTime` string, date-time — For rental assets only. (Future) ownership expiration time of the asset.
    - `supportsHeadShapes` boolean — If the "Id" is swappable, applicable for DH assets.
  - `defaultShirtApplied` boolean — Whether default clothing has been applied to this avatar.
  - `defaultPantsApplied` boolean — Whether default clothing has been applied to this avatar.
  - `emotes` RobloxApiAvatarModelsEmoteResponseModel[] — The emotes on the character
    - `assetId` integer — The asset id of the emote.
    - `assetName` string — The name of the emote.
    - `position` integer — The position the emote is equipped to.

## Other responses

- `401` — 0: Authorization has been denied for this request.

---

[API](https://skmtc.net/roblox/apis/roblox-api.md) · [All operations](https://skmtc.net/roblox/apis/roblox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/roblox/roblox-api/versions/e15802062270/schema)