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.

Example:

1

​
description
string
required

The description of the item's condition.

Maximum length: 255
Example:

"Grade A: No refurbishment needed"

​
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
Example:

"warehouse-operator@example.com"

​
note
string

Any additional notes on the item's condition.

Maximum length: 65535
Example:

"This item is missing the original packaging. Light refurbishment required. Scuff marks on the back of the item."

​
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.

Example:

"2024-03-31 23:59:59"