--- title: InventoryTransfer - GraphQL Admin description: |- Tracks the movement of [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryItem) objects between [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) objects. A transfer includes origin and destination information, [`InventoryTransferLineItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryTransferLineItem) objects with quantities, and shipment details. Transfers progress through multiple [`statuses`](https://shopify.dev/docs/api/admin-graphql/latest/enums/InventoryTransferStatus). The transfer maintains [`LocationSnapshot`](https://shopify.dev/docs/api/admin-graphql/latest/objects/LocationSnapshot) objects of location details to preserve historical data even if locations change or are deleted later. api_version: 2025-07 api_name: admin type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/2025-07/objects/inventorytransfer md: https://shopify.dev/docs/api/admin-graphql/2025-07/objects/inventorytransfer.md --- # Inventory​Transfer object Requires `read_inventory_transfers` access scope. Also: The user must have permission to view products. Tracks the movement of [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryItem) objects between [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) objects. A transfer includes origin and destination information, [`InventoryTransferLineItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryTransferLineItem) objects with quantities, and shipment details. Transfers progress through multiple [`statuses`](https://shopify.dev/docs/api/admin-graphql/latest/enums/InventoryTransferStatus). The transfer maintains [`LocationSnapshot`](https://shopify.dev/docs/api/admin-graphql/latest/objects/LocationSnapshot) objects of location details to preserve historical data even if locations change or are deleted later. ## Fields * date​Created [Date​Time](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/DateTime) The date and time the inventory transfer was created in UTC format. * destination [Location​Snapshot](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/LocationSnapshot) Snapshot of the destination location (name, address, when snapped) with an optional link to the live Location object. If the original location is deleted, the snapshot data will still be available but the location link will be nil. * events [Event​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/EventConnection) non-null The list of events associated with the inventory transfer. * has​Timeline​Comment [Boolean!](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/Boolean) non-null Whether the merchant has added timeline comments to the inventory transfer. * id [ID!](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/ID) non-null A globally-unique ID. * line​Items [Inventory​Transfer​Line​Item​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/InventoryTransferLineItemConnection) non-null The line items associated with the inventory transfer. * line​Items​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Count) The number of line items associated with the inventory transfer. Limited to a maximum of 10000 by default. * metafield [Metafield](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/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. * metafields [Metafield​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/MetafieldConnection) non-null A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. * name [String!](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/String) non-null The name of the inventory transfer. * note [String](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/String) Additional note attached to the inventory transfer. * origin [Location​Snapshot](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/LocationSnapshot) Snapshot of the origin location (name, address, when snapped) with an optional link to the live Location object. If the original location is deleted, the snapshot data will still be available but the location link will be nil. * received​Quantity [Int!](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/Int) non-null The total quantity of items received in the transfer. * reference​Name [String](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/String) The reference name of the inventory transfer. * shipments [Inventory​Shipment​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/InventoryShipmentConnection) non-null The shipments associated with the inventory transfer. * status [Inventory​Transfer​Status!](https://shopify.dev/docs/api/admin-graphql/2025-07/enums/InventoryTransferStatus) non-null The current status of the transfer. * tags [\[String!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/String) non-null A list of tags that have been added to the inventory transfer. * total​Quantity [Int!](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/Int) non-null The total quantity of items being transferred. * metafield​Definitions [Metafield​Definition​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/MetafieldDefinitionConnection) non-nullDeprecated *** ## Map ### Fields and connections with this object * <->[InventoryTransferConnection.nodes](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/InventoryTransferConnection#returns-nodes) * {}[InventoryTransferEdge.node](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/InventoryTransferEdge#field-InventoryTransferEdge.fields.node) ### Possible type in * [Comment​Event​Embed](https://shopify.dev/docs/api/admin-graphql/2025-07/unions/CommentEventEmbed) *** ## Queries * [inventory​Transfer](https://shopify.dev/docs/api/admin-graphql/2025-07/queries/inventoryTransfer) query Returns an [`InventoryTransfer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryTransfer) by ID. Inventory transfers track the movement of inventory between locations, including origin and destination details, [`InventoryTransferLineItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryTransferLineItem) objects, quantities, and [`InventoryTransferStatus`](https://shopify.dev/docs/api/admin-graphql/latest/enums/InventoryTransferStatus) values. * [inventory​Transfers](https://shopify.dev/docs/api/admin-graphql/2025-07/queries/inventoryTransfers) query Returns a paginated list of [`InventoryTransfer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryTransfer) objects between locations. Transfers track the movement of [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryItem) objects between [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) objects. Supports filtering transfers using query parameters and sorting by various criteria. Use the connection's edges to access transfer details including [`InventoryTransferLineItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryTransferLineItem) objects, quantities, and shipment status. *** ## \InventoryTransfer Queries ### Queried by * \[inventory​Transfer](https://shopify.dev/docs/api/admin-graphql/2025-07/queries/inventoryTransfer) * \[inventory​Transfers](https://shopify.dev/docs/api/admin-graphql/2025-07/queries/inventoryTransfers) *** ## Mutations * [inventory​Transfer​Cancel](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryTransferCancel) mutation Cancels an inventory transfer. * [inventory​Transfer​Create](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryTransferCreate) mutation Creates a draft inventory transfer to move inventory items between [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) objects in your store. The transfer tracks which items to move, their quantities, and the origin and destination locations. Use [`inventoryTransferMarkAsReadyToShip`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/inventoryTransferMarkAsReadyToShip) to mark the transfer as ready to ship. *** Caution As of version `2026-01`, this mutation supports an optional idempotency key using the `@idempotent` directive. As of version `2026-04`, the idempotency key is required and must be provided using the `@idempotent` directive. For more information, see the [idempotency documentation](https://shopify.dev/docs/api/admin/idempotency). *** * [inventory​Transfer​Create​As​Ready​To​Ship](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryTransferCreateAsReadyToShip) mutation Creates an inventory transfer in ready to ship. *** Caution As of 2026-01, this mutation supports an optional idempotency key using the `@idempotent` directive. As of 2026-04, the idempotency key is required and must be provided using the `@idempotent` directive. For more information, see the [idempotency documentation](https://shopify.dev/docs/api/admin/idempotency). *** * [inventory​Transfer​Duplicate](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryTransferDuplicate) mutation 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. *** Caution As of 2026-01, this mutation supports an optional idempotency key using the `@idempotent` directive. As of 2026-04, the idempotency key is required and must be provided using the `@idempotent` directive. For more information, see the [idempotency documentation](https://shopify.dev/docs/api/admin/idempotency). *** * [inventory​Transfer​Edit](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryTransferEdit) mutation Edits an inventory transfer. * [inventory​Transfer​Mark​As​Ready​To​Ship](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryTransferMarkAsReadyToShip) mutation Sets an inventory transfer to ready to ship. * [inventory​Transfer​Remove​Items](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryTransferRemoveItems) mutation This mutation allows removing the shippable quantities of line items on a Transfer. It removes all quantities of the item from the transfer that are not associated with shipments. * [inventory​Transfer​Set​Items](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryTransferSetItems) mutation This mutation allows for the setting of line items on a Transfer. Will replace the items already set, if any. *** Caution As of 2026-01, this mutation supports an optional idempotency key using the `@idempotent` directive. As of 2026-04, the idempotency key is required and must be provided using the `@idempotent` directive. For more information, see the [idempotency documentation](https://shopify.dev/docs/api/admin/idempotency). *** *** ## <\~> InventoryTransfer Mutations ### Mutated by * <\~>[inventory​Transfer​Cancel](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryTransferCancel) * <\~>[inventory​Transfer​Create](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryTransferCreate) * <\~>[inventory​Transfer​Create​As​Ready​To​Ship](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryTransferCreateAsReadyToShip) * <\~>[inventory​Transfer​Duplicate](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryTransferDuplicate) * <\~>[inventory​Transfer​Edit](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryTransferEdit) * <\~>[inventory​Transfer​Mark​As​Ready​To​Ship](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryTransferMarkAsReadyToShip) * <\~>[inventory​Transfer​Remove​Items](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryTransferRemoveItems) * <\~>[inventory​Transfer​Set​Items](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryTransferSetItems) *** ## Interfaces * * [Comment​Event​Subject](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/CommentEventSubject) interface * [Has​Events](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/HasEvents) interface * [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/HasMetafieldDefinitions) interface * [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/HasMetafields) interface * [Node](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/Node) interface *** ## ||-InventoryTransfer Implements ### Implements * ||-[Comment​Event​Subject](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/CommentEventSubject) * ||-[Has​Events](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/HasEvents) * ||-[Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/HasMetafieldDefinitions) * ||-[Has​Metafields](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/HasMetafields) * ||-[Node](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/Node)