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
Request body
SetReturnDispositionRequest
Explicit target bin; otherwise the warehouse’s
returns (restock) or quarantine bin is used when one exists.Lot the received units belong to; restocked/quarantined units are restored to it in the same transaction.
Serial numbers physically received (count must equal the item quantity); each is marked
returned and moved to the disposition’s target status.Response
ReturnItemResponse
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