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

X-Authorization
string
header
required

Body

application/json
items
object[]
required

An array of items to grade.

Response

200
application/json
Success
line_item_id
integer
required

The unique identifier associated with the line item.

description
string
required

The description of the item's condition.

Maximum length: 255
condition_category
enum<string>

The condition of the returned item.

Available options:
grade_a,
grade_b,
grade_c,
grade_d,
incorrect_item,
missing,
junk
return_processor
string

The email address of the warehouse partner used to process returns.

Maximum length: 100
note
string

Any additional notes on the item's condition.

Maximum length: 65535
images
string[]

An array of links to images of the item.

inspected_at
string

The date and time at which the item was inspected, using the ISO 8601 date format.