---
title: "Grade Items"
method: POST
path: "/dispositioning/grade"
tags: ["Grade Items"]
---

# Grade Items

`POST /dispositioning/grade`

Grade the condition of return line items.

### Required API key scope
- Returns

## Request body

- GradeRequest
  - `items` ItemCondition[], required — An array of items to grade.
    - `line_item_id` integer, required — The unique identifier associated with the line item.
    - `description` string, required — The description of the item's condition.
    - `condition_category` object, nullable — 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.
      - `subject` string, nullable — The condition category subject.
      - `title` string, nullable — The condition category title.
      - `grade` string, nullable — The condition grade.
      - `category_name` string, nullable — The condition category name.
      - `category_parent` string, nullable — The parent condition category.
    - `return_processor` string — The email address of the warehouse partner used to process returns.
    - `note` string — Any additional notes on the item's condition.
    - `images` Image[] — An array of links to images of the item.
    - `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.

## Response `200`

Success

- ItemCondition[]
  - `line_item_id` integer, required — The unique identifier associated with the line item.
  - `description` string, required — The description of the item's condition.
  - `condition_category` object, nullable — 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.
    - `subject` string, nullable — The condition category subject.
    - `title` string, nullable — The condition category title.
    - `grade` string, nullable — The condition grade.
    - `category_name` string, nullable — The condition category name.
    - `category_parent` string, nullable — The parent condition category.
  - `return_processor` string — The email address of the warehouse partner used to process returns.
  - `note` string — Any additional notes on the item's condition.
  - `images` Image[] — An array of links to images of the item.
  - `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.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden — one or more line items do not belong to the authenticated shop.
- `422` — Unprocessable

---

[API](https://skmtc.dev/loopreturns/apis/listings-api.md) · [All operations](https://skmtc.dev/loopreturns/apis/listings-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loopreturns/listings-api/revisions/750e6012dbb8/schema)