POST
/
v1
/
returns
/
:id
/
inspect
curl --location --request POST 'https://api.stateset.com/v1/returns/:id/inspect' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <token>' \
--data-raw '{
    "id": "rt_1NXWPnCo6bFb1KQto6C8OWvE",
    "inspection_type": "physical",
    "condition_assessment": "good",
    "inspector_notes": "Minor wear on packaging, product unused",
    "defects_found": ["packaging_damage"],
    "resellable": true,
    "restocking_fee": 15.00
}'

{
  "id": "rt_1NXWPnCo6bFb1KQto6C8OWvE",
  "object": "return",
  "inspected": true,
  "inspection_id": "insp_ret_123",
  "inspection_date": "2024-01-15T10:45:00Z",
  "condition_assessment": "good",
  "resellable": true,
  "restocking_fee": 15.00,
  "defects_found": ["packaging_damage"],
  "recommended_action": "restock"
}

​
Body

​
return_id
string
The ID provided in the data tab may be used to identify the return
​
inspection_type
string
The type of inspection performed (e.g., “physical”, “functional”, “cosmetic”)
​
condition_assessment
string
The assessed condition of the returned item (e.g., “like_new”, “good”, “fair”, “poor”, “damaged”)
​
inspector_notes
string
Detailed notes from the inspection
​
defects_found
array
List of defects or issues found during inspection
​
resellable
boolean
Whether the item can be resold
​
restocking_fee
number
Recommended restocking fee based on condition

​
Response

​
id
string
The ID provided in the data tab may be used to identify the return
​
object
string
The object type
​
inspection_id
string
The unique identifier for the inspection record
​
inspection_date
string
The date when the inspection was performed
​
condition_assessment
string
The final condition assessment
​
resellable
boolean
Whether the item can be resold
​
recommended_action
string
The recommended action based on inspection (e.g., “restock”, “liquidate”, “dispose”)
​
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/inspect' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <token>' \
--data-raw '{
    "id": "rt_1NXWPnCo6bFb1KQto6C8OWvE",
    "inspection_type": "physical",
    "condition_assessment": "good",
    "inspector_notes": "Minor wear on packaging, product unused",
    "defects_found": ["packaging_damage"],
    "resellable": true,
    "restocking_fee": 15.00
}'

{
  "id": "rt_1NXWPnCo6bFb1KQto6C8OWvE",
  "object": "return",
  "inspected": true,
  "inspection_id": "insp_ret_123",
  "inspection_date": "2024-01-15T10:45:00Z",
  "condition_assessment": "good",
  "resellable": true,
  "restocking_fee": 15.00,
  "defects_found": ["packaging_damage"],
  "recommended_action": "restock"
}