---
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`

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 — 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.

---

[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/revisions/ece7c5a315e7/schema)