---
title: "List Inventory Items"
method: GET
path: "/cloud/v2/users/{user_id}/inventory-items"
tags: ["Inventories", "Users"]
---

# List Inventory Items

`GET /cloud/v2/users/{user_id}/inventory-items`

List the inventory items in a user's inventory.

The inventory items returned depend on the target user’s choice under
**Settings > Privacy > Who can see my inventory?**:
* If the user granted inventory visibility to "Everyone," then any API key
or OAuth2 token can be used to view the target’s inventory, no matter what
scopes it has or who created it.
* If the user has not granted inventory visibility to "Everyone":
  * Their inventory can still be viewed with an API key created by the
  target user with **Inventory: Read** permission.
  * Their inventory can still be viewed with an OAuth2 token if the target
  user authorizes an app requesting permissions for the
  `user.inventory-item:read` scope.

## Path parameters

- `user_id` string, required

## Query parameters

- `maxPageSize` integer
- `pageToken` string
- `filter` string

## Response `200`

OK

- ListInventoryItemsResponse — A list of InventoryItems in the parent collection.
  - `inventoryItems` InventoryItem[] — The InventoryItems from the specified User.
    - `path` string — The resource path of the inventory item. Format: `users/{user_id}/inventory-items/{inventory_item_id}`
    - `assetDetails` InventoryItemAssetDetails — Specific fields only applicable to assets
      - `assetId` string — A unique ID that identifies an asset.
      - `inventoryItemAssetType` 'INVENTORY_ITEM_ASSET_TYPE_UNSPECIFIED' | 'CLASSIC_TSHIRT' | 'AUDIO' | 'HAT' | 'MODEL' | 'CLASSIC_SHIRT' | 'CLASSIC_PANTS' | 'DECAL' | 'CLASSIC_HEAD' | 'FACE' | 'GEAR' | 'ANIMATION' | 'TORSO' | 'RIGHT_ARM' | 'LEFT_ARM' | 'LEFT_LEG' | 'RIGHT_LEG' | 'PACKAGE' | 'PLUGIN' | 'MESH_PART' | 'HAIR_ACCESSORY' | 'FACE_ACCESSORY' | 'NECK_ACCESSORY' | 'SHOULDER_ACCESSORY' | 'FRONT_ACCESSORY' | 'BACK_ACCESSORY' | 'WAIST_ACCESSORY' | 'CLIMB_ANIMATION' | 'DEATH_ANIMATION' | 'FALL_ANIMATION' | 'IDLE_ANIMATION' | 'JUMP_ANIMATION' | 'RUN_ANIMATION' | 'SWIM_ANIMATION' | 'WALK_ANIMATION' | 'POSE_ANIMATION' | 'EMOTE_ANIMATION' | 'VIDEO' | 'TSHIRT_ACCESSORY' | 'SHIRT_ACCESSORY' | 'PANTS_ACCESSORY' | 'JACKET_ACCESSORY' | 'SWEATER_ACCESSORY' | 'SHORTS_ACCESSORY' | 'LEFT_SHOE_ACCESSORY' | 'RIGHT_SHOE_ACCESSORY' | 'DRESS_SKIRT_ACCESSORY' | 'EYEBROW_ACCESSORY' | 'EYELASH_ACCESSORY' | 'MOOD_ANIMATION' | 'DYNAMIC_HEAD' | 'CREATED_PLACE' | 'PURCHASED_PLACE', enum — The specific asset type of this item. Possible values: | Value | Description | | --- | --- | | INVENTORY_ITEM_ASSET_TYPE_UNSPECIFIED | Default InventoryItemAssetType | | CLASSIC_TSHIRT | Classic Tshirt | | AUDIO | Audio | | HAT | Hat | | MODEL | Model | | CLASSIC_SHIRT | Classic Shirt | | CLASSIC_PANTS | Classic Pants | | DECAL | Decal | | CLASSIC_HEAD | Classic Head | | FACE | Face | | GEAR | Gear | | ANIMATION | Animation | | TORSO | Torso | | RIGHT_ARM | Right Arm | | LEFT_ARM | Left Arm | | LEFT_LEG | Left Leg | | RIGHT_LEG | Right Leg | | PACKAGE | Package | | PLUGIN | Plugin | | MESH_PART | Mesh Part | | HAIR_ACCESSORY | Hair Accessory | | FACE_ACCESSORY | Face Accessory | | NECK_ACCESSORY | Neck Accessory | | SHOULDER_ACCESSORY | Shoulder Accessory | | FRONT_ACCESSORY | Front Accessory | | BACK_ACCESSORY | Back Accessory | | WAIST_ACCESSORY | Waist Accessory | | CLIMB_ANIMATION | Climb Animation | | DEATH_ANIMATION | Death Animation | | FALL_ANIMATION | Fall Animation | | IDLE_ANIMATION | Idle Animation | | JUMP_ANIMATION | Jump Animation | | RUN_ANIMATION | Run Animation | | SWIM_ANIMATION | Swim Animation | | WALK_ANIMATION | Walk Animation | | POSE_ANIMATION | Pose Animation | | EMOTE_ANIMATION | Emote Animation | | VIDEO | Video | | TSHIRT_ACCESSORY | Tshirt Accessory | | SHIRT_ACCESSORY | Shirt Accessory | | PANTS_ACCESSORY | Pants Accessory | | JACKET_ACCESSORY | Jacket Accessory | | SWEATER_ACCESSORY | Sweater Accessory | | SHORTS_ACCESSORY | Shorts Accessory | | LEFT_SHOE_ACCESSORY | Left Shoe Accessory | | RIGHT_SHOE_ACCESSORY | Right Shoe Accessory | | DRESS_SKIRT_ACCESSORY | Dress Skirt Accessory | | EYEBROW_ACCESSORY | Eyebrow Accessory | | EYELASH_ACCESSORY | Eyelash Accessory | | MOOD_ANIMATION | Mood Animation | | DYNAMIC_HEAD | Dynamic Head | | CREATED_PLACE | Created Place | | PURCHASED_PLACE | Purchased Place |
      - `instanceId` string — A unique ID that identifies an instance or "copy" of the asset that's owned by a user.
      - `collectibleDetails` InventoryItemCollectibleDetails — Specific fields that are applicable to a collectible.
        - `itemId` string — A unique ID of a Roblox item that is a collectible.
        - `instanceId` string — A unique ID of an individual copy of a collectible with ownership tied to a group or user.
        - `instanceState` 'COLLECTIBLE_ITEM_INSTANCE_STATE_UNSPECIFIED' | 'AVAILABLE' | 'HOLD', enum — The instance state of this specific Collectible Item Instance which affects whether it can be resold or traded. Possible values: | Value | Description | | --- | --- | | COLLECTIBLE_ITEM_INSTANCE_STATE_UNSPECIFIED | Default CollectibleItemInstanceState | | AVAILABLE | Collectible item is available for all actions | | HOLD | Collectible item is on hold (can't be resold or traded) |
        - `serialNumber` integer — If the asset is a Limited, a user-visible number that shows this item is the nth replica of the asset. Otherwise, this attribute will be omitted.
    - `badgeDetails` InventoryItemBadgeDetails — Specific fields that are applicable to a badge.
      - `badgeId` string — A unique ID that identifies a badge.
    - `gamePassDetails` InventoryItemGamePassDetails — Specific fields that are applicable to a game pass.
      - `gamePassId` string — A unique ID that identifies a game pass.
    - `privateServerDetails` InventoryItemPrivateServerDetails — Specific fields that are applicable to a private server.
      - `privateServerId` string — A unique ID that identifies a private server.
    - `addTime` string, date-time — The time when the item was added to the user's inventory. For example, the time when the user purchased a private server or was awarded a badge. This field is currently not populated for passes.
  - `nextPageToken` string — A token that you can send as a `pageToken` parameter to retrieve the next page. If this field is omitted, there are no subsequent pages.

---

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