POST
/
v1
/
returns
/
:id
/
restock
curl --location --request POST 'https://api.stateset.com/v1/returns/:id/restock' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <token>' \
--data-raw '{
    "id": "rt_1NXWPnCo6bFb1KQto6C8OWvE",
    "warehouse_id": "wh_east_01",
    "location_id": "loc_a1_shelf_3",
    "condition_code": "new",
    "quantity": 1,
    "restocking_fee_applied": true
}'
{
  "id": "rt_1NXWPnCo6bFb1KQto6C8OWvE",
  "object": "return",
  "restocked": true,
  "inventory_adjustment_id": "inv_adj_456",
  "new_inventory_level": 150,
  "warehouse_id": "wh_east_01",
  "location_id": "loc_a1_shelf_3",
  "condition_code": "new",
  "restocked_at": "2024-01-15T11:00:00Z"
}

Body

return_id
string
The ID provided in the data tab may be used to identify the return
warehouse_id
string
The warehouse ID where the item will be restocked
location_id
string
The specific location within the warehouse
condition_code
string
The condition code for inventory classification (e.g., “new”, “refurbished”, “open_box”)
quantity
number
The quantity to restock
restocking_fee_applied
boolean
Whether a restocking fee was applied to this return

Response

id
string
The ID provided in the data tab may be used to identify the return
object
string
The object type
restocked
boolean
Indicates whether the item was successfully restocked
inventory_adjustment_id
string
The ID of the inventory adjustment record
new_inventory_level
number
The new inventory level after restocking
warehouse_id
string
The warehouse where the item was restocked
restocked_at
string
The timestamp when the item was restocked
success
number
Indicates whether the call was successful. true if successful, false if not.
curl --location --request POST 'https://api.stateset.com/v1/returns/:id/restock' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <token>' \
--data-raw '{
    "id": "rt_1NXWPnCo6bFb1KQto6C8OWvE",
    "warehouse_id": "wh_east_01",
    "location_id": "loc_a1_shelf_3",
    "condition_code": "new",
    "quantity": 1,
    "restocking_fee_applied": true
}'
{
  "id": "rt_1NXWPnCo6bFb1KQto6C8OWvE",
  "object": "return",
  "restocked": true,
  "inventory_adjustment_id": "inv_adj_456",
  "new_inventory_level": 150,
  "warehouse_id": "wh_east_01",
  "location_id": "loc_a1_shelf_3",
  "condition_code": "new",
  "restocked_at": "2024-01-15T11:00:00Z"
}