curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.stateset.com/api/v1/returns/{id}/items/{item_id}/disposition' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"bin_id": 1001,
"disposition": "string",
"disposition_by": "string",
"lot_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"serial_ids": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"warehouse_id": 1001
}'
{
"condition": "string",
"disposition": "string",
"disposition_at": "2026-08-31T14:22:05Z",
"disposition_by": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"lot_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Two-Person Tent",
"order_item_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"quantity": 2,
"refund_amount": "49.00",
"return_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"serial_ids": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"sku": "SKU-TENT-2P-GRN"
}
Return item set disposition
Disposition recorded; stock, serial and lot effects applied
POST
/
api
/
v1
/
returns
/
{id}
/
items
/
{item_id}
/
disposition
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.stateset.com/api/v1/returns/{id}/items/{item_id}/disposition' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"bin_id": 1001,
"disposition": "string",
"disposition_by": "string",
"lot_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"serial_ids": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"warehouse_id": 1001
}'
{
"condition": "string",
"disposition": "string",
"disposition_at": "2026-08-31T14:22:05Z",
"disposition_by": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"lot_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Two-Person Tent",
"order_item_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"quantity": 2,
"refund_amount": "49.00",
"return_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"serial_ids": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"sku": "SKU-TENT-2P-GRN"
}
Confirm your deployment before running this request. This page describes an API contract;
a published reference does not establish hosted availability. Check the dated
host report and obtain your deployment URL and credentials.
Replace the example host if your provisioned service uses a different URL.
Path parameters
string
required
Return ID (UUID)
string
required
Return item ID (UUID)
Request body
SetReturnDispositionRequest
integer,null (int32)
Explicit target bin; otherwise the warehouse’s
returns (restock) or quarantine bin is used when one exists.string
required
One of
restock, refurbish, scrap, return_to_vendor, quarantine.string,null
string,null (uuid)
Lot the received units belong to; restocked/quarantined units are restored to it in the same transaction.
string[]
Serial numbers physically received (count must equal the item quantity); each is marked
returned and moved to the disposition’s target status.integer,null (int32)
Warehouse receiving the stock (default 1).
Response
ReturnItemResponse
string
required
string,null
string,null
string,null
string
required
string,null
string
required
string
required
integer (int32)
required
string
required
string
required
string[]
required
string
required
Status codes
| Code | Meaning |
|---|---|
200 | Disposition recorded; stock, serial and lot effects applied |
400 | Invalid disposition / stock, serial or lot effect rejected |
403 | Return not yet received |
404 | Return not found |
409 | Item already dispositioned |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.stateset.com/api/v1/returns/{id}/items/{item_id}/disposition' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"bin_id": 1001,
"disposition": "string",
"disposition_by": "string",
"lot_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"serial_ids": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"warehouse_id": 1001
}'
{
"condition": "string",
"disposition": "string",
"disposition_at": "2026-08-31T14:22:05Z",
"disposition_by": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"lot_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Two-Person Tent",
"order_item_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"quantity": 2,
"refund_amount": "49.00",
"return_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"serial_ids": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
],
"sku": "SKU-TENT-2P-GRN"
}
Last modified on October 20, 2026