> ## Documentation Index
> Fetch the complete documentation index at: https://redo-44af351d-docs-v3-graphql-api-reference.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ReturnItem

> A single item on the return.

<ResponseField name="assessments" type={<a href="/docs/api-reference/v3/reference/returns/assessment">[Assessment!]</a>}>
  Merchant assessments recorded for the item, if any.

  <Expandable title="fields" lazyRender>
    <ResponseField name="assignedUser" type={<a href="/docs/api-reference/v3/reference/returns/assessment-user">AssessmentUser!</a>} required>
      The user who performed the assessment.

      <Expandable title="fields" lazyRender>
        <ResponseField name="email" type="String!" required>
          The user's email.
        </ResponseField>

        <ResponseField name="firstName" type="String!" required>
          The user's first name.
        </ResponseField>

        <ResponseField name="id" type="String!" required>
          The assigned user's id.
        </ResponseField>

        <ResponseField name="lastName" type="String!" required>
          The user's last name.
        </ResponseField>

        <ResponseField name="name" type="String!" required>
          The user's full name.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="responses" type={<a href="/docs/api-reference/v3/reference/returns/assessment-response">[AssessmentResponse!]!</a>} required>
      The assessment responses.

      <Expandable title="fields" lazyRender>
        <ResponseField name="type" type="String!" required>
          The response type.
        </ResponseField>

        <ResponseField name="value" type={<a href="/docs/api-reference/v3/reference/common/json">JSON</a>}>
          The response value (shape depends on the type).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="customerComment" type="String!" required>
  Free-text comments the customer left for this item.
</ResponseField>

<ResponseField name="exchangeItem" type={<a href="/docs/api-reference/v3/reference/returns/return-item-exchange-item">ReturnItemExchangeItem</a>}>
  The item exchanged for this one, if an exchange.

  <Expandable title="fields" lazyRender>
    <ResponseField name="product" type={<a href="/docs/api-reference/v3/reference/returns/external-ref">ExternalRef!</a>} required>
      The exchanged-for product.

      <Expandable title="fields" lazyRender>
        <ResponseField name="externalId" type="String">
          The external id.
        </ResponseField>

        <ResponseField name="name" type="String">
          The display name.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="quantity" type="Int!" required>
      The exchanged quantity.
    </ResponseField>

    <ResponseField name="variant" type={<a href="/docs/api-reference/v3/reference/returns/external-ref">ExternalRef!</a>} required>
      The exchanged-for variant.

      <Expandable title="fields" lazyRender>
        <ResponseField name="externalId" type="String">
          The external id.
        </ResponseField>

        <ResponseField name="name" type="String">
          The display name.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="externalIdentifier" type="String">
  A merchant-set external identifier for the item.
</ResponseField>

<ResponseField name="externalReturnLineItemId" type="String">
  The external return line item id, if any.
</ResponseField>

<ResponseField name="grade" type="String">
  The merchant-assigned grade.
</ResponseField>

<ResponseField name="greenReturn" type="Boolean">
  Whether the item is a green (keep-it) return.
</ResponseField>

<ResponseField name="id" type="String!" required>
  The return item id.
</ResponseField>

<ResponseField name="multipleChoiceQuestions" type={<a href="/docs/api-reference/v3/reference/returns/multiple-choice-question">[MultipleChoiceQuestion!]!</a>} required>
  Multiple-choice question answers for the item.

  <Expandable title="fields" lazyRender>
    <ResponseField name="answer" type="String!" required>
      The chosen answer.
    </ResponseField>

    <ResponseField name="question" type="String!" required>
      The question.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="orderLineItemId" type="String">
  The id of the order line item this return item came from.
</ResponseField>

<ResponseField name="outcome" type="String">
  The merchant-assigned processing outcome.
</ResponseField>

<ResponseField name="processingImages" type="[String!]!" required>
  Merchant-uploaded processing images.
</ResponseField>

<ResponseField name="processingNotes" type="String">
  Merchant processing notes.
</ResponseField>

<ResponseField name="productAdjustment" type="String">
  The merchant price adjustment for the item.
</ResponseField>

<ResponseField name="productId" type="String">
  The item's product id.
</ResponseField>

<ResponseField name="productValueNoTaxNoAdjustment" type={<a href="/docs/api-reference/v3/reference/returns/return-amount">ReturnAmount!</a>} required>
  The item's product value excluding tax and adjustments.

  <Expandable title="fields" lazyRender>
    <ResponseField name="amount" type={<a href="/docs/api-reference/v3/reference/common/money">Money!</a>} required>
      The amount.

      <Expandable title="fields" lazyRender>
        <ResponseField name="amount" type={<a href="/docs/api-reference/v3/reference/common/decimal">Decimal!</a>} required>
          The exact amount as a decimal string (e.g. "19.99").
        </ResponseField>

        <ResponseField name="currency" type="String!" required>
          ISO 4217 currency code (e.g. USD).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="quantity" type="Int!" required>
  The returned quantity.
</ResponseField>

<ResponseField name="reason" type="String">
  The return reason.
</ResponseField>

<ResponseField name="reasonCode" type="String">
  The return reason code.
</ResponseField>

<ResponseField name="reasonCodes" type="[String!]!" required>
  All return reason codes.
</ResponseField>

<ResponseField name="reasons" type="[String!]!" required>
  All return reasons.
</ResponseField>

<ResponseField name="refund" type={<a href="/docs/api-reference/v3/reference/returns/item-refund">ItemRefund!</a>} required>
  The refund for this item.

  <Expandable title="fields" lazyRender>
    <ResponseField name="amount" type={<a href="/docs/api-reference/v3/reference/common/money">Money!</a>} required>
      The refunded amount for the item.

      <Expandable title="fields" lazyRender>
        <ResponseField name="amount" type={<a href="/docs/api-reference/v3/reference/common/decimal">Decimal!</a>} required>
          The exact amount as a decimal string (e.g. "19.99").
        </ResponseField>

        <ResponseField name="currency" type="String!" required>
          ISO 4217 currency code (e.g. USD).
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="type" type={<a href="/docs/api-reference/v3/reference/returns/return-item-strategy">ReturnItemStrategy</a>}>
      The compensation strategy (null for exchanges).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="shipmentGroupIds" type="[String!]!" required>
  Shipment groups this item belongs to.
</ResponseField>

<ResponseField name="sku" type="String">
  The item's SKU.
</ResponseField>

<ResponseField name="status" type={<a href="/docs/api-reference/v3/reference/returns/return-item-status">ReturnItemStatus</a>}>
  The item's processing status.
</ResponseField>

<ResponseField name="upc" type="String">
  The item's barcode/UPC.
</ResponseField>

<ResponseField name="variantId" type="String">
  The item's variant id.
</ResponseField>
