Skip to main content
POST
https://api.stateset.com
/
v1
/
inventory_items
/
:id
/
transfer
curl --location --request POST 'https://api.stateset.com/v1/inventory_items/:id/transfer' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <token>' \
--data-raw '{
    "inventory_item_id": "inv_abc123",
    "quantity": 50,
    "from_warehouse_id": "wh_east_01",
    "from_location_id": "loc_a1_shelf_3",
    "to_warehouse_id": "wh_west_01",
    "to_location_id": "loc_b2_shelf_1",
    "transfer_reason": "rebalancing",
    "priority": "standard",
    "expected_arrival": "2024-01-20"
}'

{
  "id": "trans_xyz456",
  "transfer_number": "TRF-2024-0001",
  "inventory_item_id": "inv_abc123",
  "quantity": 50,
  "from_warehouse": {
    "id": "wh_east_01",
    "name": "East Coast Warehouse",
    "location_id": "loc_a1_shelf_3"
  },
  "to_warehouse": {
    "id": "wh_west_01",
    "name": "West Coast Warehouse",
    "location_id": "loc_b2_shelf_1"
  },
  "transfer_reason": "rebalancing",
  "priority": "standard",
  "status": "in_transit",
  "expected_arrival": "2024-01-20",
  "created_at": "2024-01-15T10:00:00Z",
  "created_by": "user_123",
  "success": true
}

​
Body

​
inventory_item_id
string
The unique identifier of the inventory item to transfer
​
quantity
number
The quantity to transfer
​
from_warehouse_id
string
The source warehouse ID
​
from_location_id
string
The source location within the warehouse
​
to_warehouse_id
string
The destination warehouse ID
​
to_location_id
string
The destination location within the warehouse
​
transfer_reason
string
The reason for the transfer (e.g., “rebalancing”, “fulfillment”, “returns_processing”)
​
priority
string
Transfer priority (e.g., “standard”, “expedited”, “urgent”)
​
expected_arrival
string
Expected arrival date at destination

​
Response

​
id
string
The unique identifier of the transfer record
​
transfer_number
string
The system-generated transfer number for tracking
​
inventory_item_id
string
The inventory item being transferred
​
quantity
number
The quantity being transferred
​
from_warehouse
object
Source warehouse details
​
to_warehouse
object
Destination warehouse details
​
status
string
Transfer status (e.g., “pending”, “in_transit”, “completed”, “cancelled”)
​
created_at
string
Timestamp when the transfer was created
​
success
boolean
Indicates whether the transfer was initiated successfully
curl --location --request POST 'https://api.stateset.com/v1/inventory_items/:id/transfer' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <token>' \
--data-raw '{
    "inventory_item_id": "inv_abc123",
    "quantity": 50,
    "from_warehouse_id": "wh_east_01",
    "from_location_id": "loc_a1_shelf_3",
    "to_warehouse_id": "wh_west_01",
    "to_location_id": "loc_b2_shelf_1",
    "transfer_reason": "rebalancing",
    "priority": "standard",
    "expected_arrival": "2024-01-20"
}'

{
  "id": "trans_xyz456",
  "transfer_number": "TRF-2024-0001",
  "inventory_item_id": "inv_abc123",
  "quantity": 50,
  "from_warehouse": {
    "id": "wh_east_01",
    "name": "East Coast Warehouse",
    "location_id": "loc_a1_shelf_3"
  },
  "to_warehouse": {
    "id": "wh_west_01",
    "name": "West Coast Warehouse",
    "location_id": "loc_b2_shelf_1"
  },
  "transfer_reason": "rebalancing",
  "priority": "standard",
  "status": "in_transit",
  "expected_arrival": "2024-01-20",
  "created_at": "2024-01-15T10:00:00Z",
  "created_by": "user_123",
  "success": true
}