TransferOrder
StartTransferOrder
Changes a DRAFT transfer order to STARTED status. This decrements inventory at the source Location and marks it as in-transit.
The order must be in DRAFT status and have all required fields populated. Once started, the order can no longer be deleted, but it can be canceled via CancelTransferOrder.
Creates a transfer_order.updated webhook event.
post/v2/transfer-orders/{transfer_order_id}/start
Path parameters
transfer_order_idstring required
The ID of the transfer order to start. Must be in DRAFT status.
Request body
Example request
{
"idempotency_key": "EXAMPLE_IDEMPOTENCY_KEY_789",
"transfer_order_id": "EXAMPLE_TRANSFER_ORDER_ID_123",
"version": 1753109537351
}Response
Success
Example response
{
"transfer_order": {
"created_at": "2025-01-15T10:30:00Z",
"created_by_team_member_id": "EXAMPLE_TEAM_MEMBER_ID_789",
"destination_location_id": "EXAMPLE_DEST_LOCATION_ID_456",
"expected_at": "2025-11-09T05:00:00Z",
"id": "EXAMPLE_TRANSFER_ORDER_ID_123",
"line_items": [
{
"item_variation_id": "EXAMPLE_ITEM_VARIATION_ID_001",
"quantity_canceled": "0",
"quantity_damaged": "0",
"quantity_ordered": "5",
"quantity_pending": "5",
"quantity_received": "0",
"uid": "1"
},
{
"item_variation_id": "EXAMPLE_ITEM_VARIATION_ID_002",
"quantity_canceled": "0",
"quantity_damaged": "0",
"quantity_ordered": "3",
"quantity_pending": "3",
"quantity_received": "0",
"uid": "2"
}
],
"notes": "Example transfer order for inventory redistribution between locations",
"source_location_id": "EXAMPLE_SOURCE_LOCATION_ID_123",
"status": "STARTED",
"tracking_number": "TRACK123456789",
"updated_at": "2025-01-15T10:32:00Z",
"version": 1753118664873
}
}