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

# PFInventoryTransferInventoryItemsAsync

> Transfer inventory items. When transferring across collections, a 202 response indicates that the transfer did not complete within the timeframe of the request. You can identify the pending operations by looking for OperationStatus = 'InProgress'. You can check on the operation status at anytime within 1 day of the request by passing the TransactionToken to the GetInventoryOperationStatus API. More information about item transfer scenarios can be found here: https://learn.microsoft.com/gaming/playfab/features/economy-v2/inventory/?tabs=inventory-game-manager#transfer-inventory-items

Transfer inventory items. When transferring across collections, a 202 response indicates that the transfer did not complete within the timeframe of the request. You can identify the pending operations by looking for OperationStatus = 'InProgress'. You can check on the operation status at anytime within 1 day of the request by passing the TransactionToken to the GetInventoryOperationStatus API. More information about item transfer scenarios can be found here: [https://learn.microsoft.com/gaming/playfab/features/economy-v2/inventory/?tabs=inventory-game-manager#transfer-inventory-items](https://learn.microsoft.com/gaming/playfab/features/economy-v2/inventory/?tabs=inventory-game-manager#transfer-inventory-items)

## Syntax

```cpp theme={null}
HRESULT PFInventoryTransferInventoryItemsAsync(  
    PFEntityHandle entityHandle,  
    const PFInventoryTransferInventoryItemsRequest* request,  
    XAsyncBlock* async  
)  
```

### Parameters

**`entityHandle`**   PFEntityHandle

PFEntityHandle to use for authentication.

**`request`**   [PFInventoryTransferInventoryItemsRequest\*](https://docs.xbox.com/services/playfab/api-references/c/pfinventorytypes/structs/pfinventorytransferinventoryitemsrequest.md)

Populated request object.

**`async`**   XAsyncBlock\*\
*Inout*

XAsyncBlock for the async operation.

### Return value

Type: HRESULT

Result code for this API operation.

## Remarks

This API is available on all platforms. Transfer the specified inventory items of an entity's container Id to another entity's container Id. When the asynchronous task is complete, call [PFInventoryTransferInventoryItemsGetResultSize](https://docs.xbox.com/services/playfab/api-references/c/pfinventory/functions/pfinventorytransferinventoryitemsgetresultsize.md) and [PFInventoryTransferInventoryItemsGetResult](https://docs.xbox.com/services/playfab/api-references/c/pfinventory/functions/pfinventorytransferinventoryitemsgetresult.md) to get the result.

## Requirements

**Header:** PFInventory.h

## See also

[PFInventory members](https://docs.xbox.com/services/playfab/api-references/c/pfinventory/pfinventory_members.md)


## Related topics

- [PFInventoryTransferInventoryItemsGetResult](https://docs.xbox.com/services/playfab/api-references/c/pfinventory/functions/pfinventorytransferinventoryitemsgetresult.md)
- [Services C API overview - PFInventory.h](https://docs.xbox.com/services/playfab/api-references/c/pfinventory/pfinventory_members.md)
- [Transfer Inventory Items](https://docs.xbox.com/services/playfab/api-references/rest/economy/inventory/transfer-inventory-items.md)
- [PFInventoryTransferInventoryItemsRequest](https://docs.xbox.com/services/playfab/api-references/c/pfinventorytypes/structs/pfinventorytransferinventoryitemsrequest.md)
- [PFInventoryTransferInventoryItemsOperation](https://docs.xbox.com/services/playfab/api-references/c/pfinventorytypes/structs/pfinventorytransferinventoryitemsoperation.md)
