--- title: "Gets the definition for an outfit." method: GET path: "/v4/outfits/{outfitId}/details" tags: ["Avatars"] --- # Gets the definition for an outfit. `GET /v4/outfits/{outfitId}/details` ## Request - Base URL: `https://avatar.roblox.com` - URL: `https://avatar.roblox.com/v4/outfits/{outfitId}/details` - Auth: one of: - none - API key in cookie `.ROBLOSECURITY` Returns an Roblox.Api.Avatar.Models.V4.OutfitDefinition containing an Roblox.Api.Avatar.Models.V4.OutfitModelV4 and background Roblox.Api.Avatar.Models.V4.OutfitConfigurations. Behavior is aligned with the V1/V3 `GET v{1|3}/outfits/{userOutfitId}/details` endpoints (authentication optional). ## Path parameters - `outfitId` string, required ## Query parameters - `selectionTypes` integer[] - `checkAssetAvailability` boolean ## Headers - `Roblox-Place-Id` integer ## Response `200` OK - RobloxApiAvatarModelsV4OutfitDefinition: Details about an outfit. - `moderationStatus` string: The moderation status of the outfit, not applicable when outfit is created outside experience - `bundleId` integer: The bundle ID, currently only returned for in-experience created outfits. - `outfitModel` RobloxApiAvatarModelsV4OutfitModelV4: A model containing core outfit details. - `universeId` integer: The universe id of the outfit, null when outfit is not created in-experience - `inventoryType` string: The inventory type of the outfit. - `id` string: The outfit id. - `name` string: The outfit name. - `isEditable` boolean: Whether the outfit can be modified by the user. - `outfitType` 0 | 1 | 2 | 4 | 5 | 6: The type of the outfit. - `assets` RobloxApiAvatarModelsAssetModelV2[]: The assets on the outfit. - `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. - `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 - `scale` RobloxWebResponsesAvatarScaleModel - `height` number, double - `width` number, double - `head` number, double - `depth` number, double - `proportion` number, double - `bodyType` number, double - `playerAvatarType` 1 | 3: The player avatar type. - `outfitConfigurations` RobloxApiAvatarModelsV4OutfitConfigurations: Background configuration for an outfit. - `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. ## Other responses - `400`: 2: The outfit for the specified userOutfit is invalid. - `403`: 3: The requester does not have access to the details for the given user outfit. - `404`: 1: The specified userOutfitId is invalid. ## Changes - **2026-10-09** `a088ae4955d2`: 2 warning - added the new `6.00` enum value to the `outfitModel/outfitType` response property for the response status `200` (media type: application/json) - added the new `6.00` enum value to the `outfitModel/outfitType` response property for the response status `200` (media type: text/json) [Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/v4/outfits/:outfitId/details/get.md) --- [API](https://skmtc.dev/roblox/apis/roblox-api.md) - [All operations](https://skmtc.dev/roblox/apis/roblox-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roblox/apis/roblox-api/revisions/bcfdc20689cd?raw)