Skip to main content
POST
https://api.stateset.com
/
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"
}