Item Grading and Dispositioning
Grade Items
APIs
- Return Actions
- Return Data
- Programmatic Webhooks
- Item Grading and Dispositioning
- Cart
- Destinations
- Blocklist
- Allowlist
- Fraud Reports
- Happy Returns Shipments
- Label Requests
Item Grading and Dispositioning
Grade Items
Grade the condition of return line items.
Required API key scope
- Returns
POST
/
dispositioning
/
grade
curl --request POST \
--url https://api.loopreturns.com/api/v1/dispositioning/grade \
--header 'Content-Type: application/json' \
--header 'X-Authorization: <api-key>' \
--data '{
"items": [
{
"line_item_id": 1,
"description": "Grade A: No refurbishment needed",
"condition_category": "grade_a",
"return_processor": "warehouse-operator@example.com",
"note": "This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.",
"images": [
"https://example.com/image.jpg"
],
"inspected_at": "2024-03-31 23:59:59"
}
]
}'
[
{
"line_item_id": 1,
"description": "Grade A: No refurbishment needed",
"condition_category": "grade_a",
"return_processor": "warehouse-operator@example.com",
"note": "This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.",
"images": [
"https://example.com/image.jpg"
],
"inspected_at": "2024-03-31 23:59:59"
}
]
Authorizations
Body
application/json
Response
200
application/json
Success
The response is of type object[]
.
curl --request POST \
--url https://api.loopreturns.com/api/v1/dispositioning/grade \
--header 'Content-Type: application/json' \
--header 'X-Authorization: <api-key>' \
--data '{
"items": [
{
"line_item_id": 1,
"description": "Grade A: No refurbishment needed",
"condition_category": "grade_a",
"return_processor": "warehouse-operator@example.com",
"note": "This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.",
"images": [
"https://example.com/image.jpg"
],
"inspected_at": "2024-03-31 23:59:59"
}
]
}'
[
{
"line_item_id": 1,
"description": "Grade A: No refurbishment needed",
"condition_category": "grade_a",
"return_processor": "warehouse-operator@example.com",
"note": "This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item.",
"images": [
"https://example.com/image.jpg"
],
"inspected_at": "2024-03-31 23:59:59"
}
]