Skip to main content
POST
Grade Items

Authorizations

X-Authorization
string
header
required

Body

application/json
items
object[]
required

An array of items to grade.

Required array length: 1 - 30 elements

Response

Success

Maximum array length: 30
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 string length: 255
Example:

"Grade A: No refurbishment needed"

condition_category
object | null

The condition of the returned item, represented as a category object. On grade requests, subject and title are required when this object is provided; grade, category_name, and category_parent are optional.

return_processor
string

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

Maximum string length: 100
Example:

"warehouse-operator@example.com"

note
string

Any additional notes on the item's condition.

Maximum string length: 65535
Example:

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

images
string<uri>[]

An array of links to images of the item.

Maximum array length: 5
Maximum string length: 2048
inspected_at
string<date-time>

The date and time at which the item was inspected, in RFC 3339 (ISO 8601) format with a UTC offset (DATE_ATOM), e.g. 2024-03-31T23:59:59+00:00.

Example:

"2024-03-31T23:59:59+00:00"