# InventoryTransfer - admin - OBJECT
Version: unstable

## Description
Represents the intention to move inventory between locations.

### Access Scopes
`read_inventory_transfers` access scope.


## Fields
* [dateCreated](/docs/api/admin/unstable/scalars/DateTime): DateTime - The date and time the inventory transfer was created in UTC format.
* [destination](/docs/api/admin/unstable/objects/InventoryTransferLocation): InventoryTransferLocation! - The destination location for the transfer.
* [hasTimelineComment](/docs/api/admin/unstable/scalars/Boolean): Boolean! - Whether the merchant has added timeline comments to the inventory transfer.
* [id](/docs/api/admin/unstable/scalars/ID): ID! - A globally-unique ID.
* [lineItemCount](/docs/api/admin/unstable/scalars/Int): Int! - The number of line items associated with the inventory transfer.
* [metafield](/docs/api/admin/unstable/objects/Metafield): Metafield - A [custom field](https://shopify.dev/docs/apps/build/custom-data),
including its `namespace` and `key`, that's associated with a Shopify resource
for the purposes of adding and storing additional information.
* [metafieldsByIdentifiers](/docs/api/admin/unstable/objects/Metafield): Metafield! - The metafields associated with the resource matching the supplied list of namespaces and keys.
* [name](/docs/api/admin/unstable/scalars/String): String! - The name of the inventory transfer.
* [note](/docs/api/admin/unstable/scalars/String): String - Additional note attached to the inventory transfer.
* [origin](/docs/api/admin/unstable/objects/InventoryTransferLocation): InventoryTransferLocation! - The origin location for the transfer.
* [receivedQuantity](/docs/api/admin/unstable/scalars/Int): Int! - The total quantity of items received in the transfer.
* [referenceName](/docs/api/admin/unstable/scalars/String): String - The reference name of the inventory transfer.
* [status](/docs/api/admin/unstable/enums/InventoryTransferStatus): InventoryTransferStatus! - The current status of the transfer.
* [tags](/docs/api/admin/unstable/scalars/String): String! - A list of tags that have been added to the inventory transfer.
* [totalQuantity](/docs/api/admin/unstable/scalars/Int): Int! - The total quantity of items being transferred.

## Connections
* [events](/docs/api/admin/unstable/connections/EventConnection): EventConnection!
* [lineItems](/docs/api/admin/unstable/connections/InventoryTransferLineItemConnection): InventoryTransferLineItemConnection!
* [metafieldDefinitions](/docs/api/admin/unstable/connections/MetafieldDefinitionConnection): MetafieldDefinitionConnection!
* [metafields](/docs/api/admin/unstable/connections/MetafieldConnection): MetafieldConnection!
* [shipments](/docs/api/admin/unstable/connections/InventoryShipmentConnection): InventoryShipmentConnection!



## Related queries
* [inventoryTransfer](/docs/api/admin/unstable/queries/inventoryTransfer) Returns an inventory transfer by ID.
* [inventoryTransfers](/docs/api/admin/unstable/queries/inventoryTransfers) Returns a paginated list of transfers.

## Related mutations
* [inventoryTransferCancel](/docs/api/admin/unstable/mutations/inventoryTransferCancel) Cancels an inventory transfer.
* [inventoryTransferCreateAsReadyToShip](/docs/api/admin/unstable/mutations/inventoryTransferCreateAsReadyToShip) Creates an inventory transfer in ready to ship.
* [inventoryTransferCreate](/docs/api/admin/unstable/mutations/inventoryTransferCreate) Creates an inventory transfer.
* [inventoryTransferDuplicate](/docs/api/admin/unstable/mutations/inventoryTransferDuplicate) This mutation allows duplicating an existing inventory transfer. The duplicated transfer will have the same
line items and quantities as the original transfer, but will be in a draft state with no shipments.
* [inventoryTransferEdit](/docs/api/admin/unstable/mutations/inventoryTransferEdit) Edits an inventory transfer.
* [inventoryTransferMarkAsReadyToShip](/docs/api/admin/unstable/mutations/inventoryTransferMarkAsReadyToShip) Sets an inventory transfer to ready to ship.
* [inventoryTransferRemoveItems](/docs/api/admin/unstable/mutations/inventoryTransferRemoveItems) This mutation allows removing line items of a Transfer. It removes all quantities of the item from the transfer that are not associated with shipments.
* [inventoryTransferSetItems](/docs/api/admin/unstable/mutations/inventoryTransferSetItems) This mutation allows for the setting of line items on a Transfer. Will replace the items already set, if any.
Note, this mutation cannot be called after the transfer has been marked In Progress.

## Related Unions

## Examples