> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Return item set disposition

> Disposition recorded; stock effect applied

### Path parameters

<ParamField path="id" type="string" required>
  Return ID (UUID)
</ParamField>

<ParamField path="item_id" type="string" required>
  Return item ID (UUID)
</ParamField>

### Request body

`SetReturnDispositionRequest`

<ParamField body="bin_id" type="integer,null (int32)">
  Explicit target bin; otherwise the warehouse's `returns` (restock) or
  `quarantine` bin is used when one exists.
</ParamField>

<ParamField body="disposition" type="string" required>
  One of `restock`, `refurbish`, `scrap`, `return_to_vendor`, `quarantine`.
</ParamField>

<ParamField body="disposition_by" type="string,null" />

<ParamField body="warehouse_id" type="integer,null (int32)">
  Warehouse receiving the stock (default 1).
</ParamField>

### Response

`ReturnItemResponse`

<ResponseField name="condition" type="string" required />

<ResponseField name="disposition" type="string,null" />

<ResponseField name="disposition_at" type="string,null" />

<ResponseField name="disposition_by" type="string,null" />

<ResponseField name="id" type="string" required />

<ResponseField name="name" type="string" required />

<ResponseField name="order_item_id" type="string" required />

<ResponseField name="quantity" type="integer (int32)" required />

<ResponseField name="refund_amount" type="string" required />

<ResponseField name="return_id" type="string" required />

<ResponseField name="sku" type="string" required />

### Status codes

| Code  | Meaning                                     |
| ----- | ------------------------------------------- |
| `200` | Disposition recorded; stock effect applied  |
| `400` | Invalid disposition / stock effect rejected |
| `403` | Return not yet received                     |
| `404` | Return not found                            |
| `409` | Item already dispositioned                  |

<RequestExample>
  ```bash cURL theme={null}
  curl --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": null,
    "disposition": "string",
    "disposition_by": null,
    "warehouse_id": null
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "condition": "string",
    "disposition": null,
    "disposition_at": null,
    "disposition_by": null,
    "id": "string",
    "name": "string",
    "order_item_id": "string",
    "quantity": 1,
    "refund_amount": "string",
    "return_id": "string",
    "sku": "string"
  }
  ```
</ResponseExample>