> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Items and Inventory Overview

> Learn PlayFab Economy v2 catalog and inventory concepts, including item types, bundles, stores, virtual currencies, and player ownership tracking.

# PlayFab Items and Inventory Overview

<Info>
  Economy v2 is now Generally Available. For support and feedback, go to the [PlayFab Forum](https://community.playfab.com).
</Info>

Items and inventories are essential features for creating engaging and immersive games. They allow you to offer customization options, rewards, progression systems, and monetization opportunities for your players.

PlayFab Economy v2 provides a flexible and powerful platform for creating and managing virtual goods. You can define different types of items — such as durables, consumables, bundles, subscriptions, and virtual currencies — and track the ownership and usage of items across your players' inventories.

## Key concepts

* **Catalog** - A catalog is a collection of all the items that are available in your game. Catalogs offer an easy way to manage your game's virtual items. For more information, see the [Catalog Overview](/services/playfab/economy-monetization/economy-v2/catalog/catalog-overview).
* **Catalog Items** – Individual items defined in your catalog. They can represent any kind of virtual good, such as weapons, outfits, power-ups, loot boxes, etc. You can customize properties and behaviors to suit your game design.
* **Catalog Stores** - Stores allow you to create multiple item listings for different purposes, such as seasonal events, promotions, or testing. See [Stores](/services/playfab/economy-monetization/economy-v2/catalog/stores).
* **Bundles** - Bundles are catalog items that contain references to other items. When a player purchases a bundle, the referenced items are unpacked and added to their inventory.
* **Subscriptions** - Subscriptions grant time-based access to durable goods. Items within a subscription are available in a player's inventory for the duration of the subscription. See [Subscriptions](/services/playfab/economy-monetization/economy-v2/catalog/subscriptions).
* **Player Inventory Collections** - Inventory is a record of the items that a player owns in your game. It contains information about item amounts, virtual currency balances, and custom properties. All player accounts can have one or more inventories called [Collections](/services/playfab/economy-monetization/economy-v2/inventory/collections).
* **Stacks** - Stacks allow multiple distinct instances of the same item to exist within a single inventory, each with their own amount and custom properties. See [Stacks](/services/playfab/economy-monetization/economy-v2/inventory/stacks).
* **Virtual Currency** - Virtual currency is a type of item used as a medium of exchange in your game. You can use virtual currency to buy items from the catalog or a store, implement soft currency from in-app purchases, or drive gameplay mechanics.

## Key APIs

A rich set of APIs is available for interacting with items and inventories in your game. You can use these APIs to perform actions such as purchasing items, granting items, updating inventory, transferring items between players, and querying transaction history.

### Inventory Management

* **[GetInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-inventory-items)** - Retrieve the current inventory of an entity. Supports pagination with `ContinuationToken` and bulk loading via [TurboLoading](/services/playfab/economy-monetization/economy-v2/inventory/turboloading).
* **[AddInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/add-inventory-items)** - Add items directly to a player's inventory.
* **[SubtractInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/subtract-inventory-items)** - Reduce item amounts in a player's inventory.
* **[UpdateInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/update-inventory-items)** - Set item amounts or modify [Display Properties](/services/playfab/economy-monetization/economy-v2/inventory#display-properties) on inventory items.
* **[DeleteInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/delete-inventory-items)** - Remove entire stacks of items from a player's inventory.

### Purchasing and Trading

* **[PurchaseInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/purchase-inventory-items)** - Buy catalog items or bundles using virtual currency. Deducts the currency from the player's inventory and grants the purchased item.
* **[TransferInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/transfer-inventory-items)** - Transfer items between players, between a player's inventory collections, or between stacks within the same inventory.

### Batch Operations

* **[ExecuteInventoryOperations](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/execute-inventory-operations)** - Batch up to 10 inventory operations (Add, Subtract, Update, Purchase, Transfer, Delete) in a single atomic request. If any operation fails, the entire batch is rolled back.

### History and Diagnostics

* **[GetTransactionHistory](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-transaction-history)** - Retrieve transaction events from a player's inventory. Supports filtering by timestamp and pagination for reviewing the full operation history. See [Transaction History](/services/playfab/economy-monetization/economy-v2/inventory/transaction-history).

### Reliability

* **Idempotency** - All inventory APIs support an `IdempotencyId` parameter to safely retry requests without duplicate side effects. IDs are enforced for 14 days. See [Idempotency](/services/playfab/economy-monetization/economy-v2/inventory#idempotency).

For the full API reference and detailed examples for each operation, see the [Inventory API documentation](/services/playfab/economy-monetization/economy-v2/inventory) and the [PlayFab REST API reference](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory).


## Related topics

- [Services C API overview - PFInventory.h](/services/playfab/api-references/c/pfinventory/pfinventory_members.md)
- [Services C API overview - PFInventoryTypes.h](/services/playfab/api-references/c/pfinventorytypes/pfinventorytypes_members.md)
- [PFInventoryInventoryItem](/services/playfab/api-references/c/pfinventorytypes/structs/pfinventoryinventoryitem.md)
- [PFInventoryInventoryItemReference](/services/playfab/api-references/c/pfinventorytypes/structs/pfinventoryinventoryitemreference.md)
- [Quickstart](/services/playfab/economy-monetization/economy-v2/quickstart.md)
