--- title: "Gets the currently wearing avatar definition for the authenticated user." method: GET path: "/v4/avatar" tags: ["Avatars"] --- # Gets the currently wearing avatar definition for the authenticated user. `GET /v4/avatar` Returns an Roblox.Api.Avatar.Models.V4.AvatarDefinition containing an Roblox.Api.Avatar.Models.V4.AvatarModelV4 and Roblox.Api.Avatar.Models.V4.AvatarConfigurations. ## Query parameters - `selectionTypes` integer[], required ## Headers - `Roblox-Place-Id` integer ## Response `200` OK - RobloxApiAvatarModelsV4AvatarDefinition — Details about an avatar. - `avatarModel` RobloxApiAvatarModelsV4AvatarModelV4 — 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` RobloxApiAvatarModelsBodyColorsModelV4 — A model containing RGB hex colors for each body part. - `headColor` string — The RGB hex color for head color, e.g. #FFFFFF - `torsoColor` string — The RGB hex color for torso color, e.g. #FFFFFF - `rightArmColor` string — The RGB hex color for right arm color, e.g. #FFFFFF - `leftArmColor` string — The RGB hex color for left arm color, e.g. #FFFFFF - `rightLegColor` string — The RGB hex color for right leg color, e.g. #FFFFFF - `leftLegColor` string — The RGB hex color for left leg color, e.g. #FFFFFF - `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. - `avatarConfigurations` RobloxApiAvatarModelsV4AvatarConfigurations — Avatar config details. - `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. - `background` RobloxApiAvatarModelsV4AvatarBackgroundModel — A model containing avatar background data. - `backgroundAsset` RobloxApiAvatarModelsAssetModelV2 — A model containing details about an asset - V2: adds CurrentVersionId, AssetMetaModel - `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. - `thumbnailCustomizations` RobloxApiAvatarModelsAvatarThumbnailCustomizationModel[] — List of customizations set for this avatar. At most one per thumbnail type (Closeup, FullBody). - `thumbnailType` 0 | 1 | 2 — What type of 2D thumbnail are we customizing: |Closeup, FullBody. - `emoteAssetId` integer — What emote are we using to pose the avatar in the thumbnail. - `camera` RobloxApiAvatarModelsAvatarThumbnailCustomizationCameraModel — A model describing a the camera details for a single avatar thumbnail customization. - `fieldOfViewDeg` number, double — Field of view for the camera, in degrees. - `yRotDeg` number, double — Rotation around y axis, in degrees. - `distanceScale` number, double — There's a natural camera distance we calculate based on avatar size. Apply this scale to that distance. - `profileFrame` RobloxApiAvatarModelsV4AvatarProfileFrameModel — A model containing avatar profile frame data. - `frameAsset` RobloxApiAvatarModelsAssetModelV2 — A model containing details about an asset - V2: adds CurrentVersionId, AssetMetaModel - `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. ## 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)