> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ReturnShipmentGroup

> A group of return items shipped together under a single label, with the address they're returned to.

**destination** *required*

The address the group's items are returned to.

**fields**

**address1** `String`

The first line of the address (street and number).

**address2** `String`

The second line of the address (apartment, suite, unit, etc.).

**city** `String`

The city, town, or village.

**country** `String`

The country.

**postalCode** `String`

The postal or ZIP code.

**province** `String`

The province, state, or region.

**externalLocationId** `String`

The destination external location id, if any.

**id** `ID!` *required*

The id of this shipment group.

**items** *required*

The return items assigned to this group's label.

**fields**

**customerComment** `String!` *required*

Free-text comments the customer left for this item.

**exchangeItem**

The item exchanged for this one, if an exchange.

**fields**

**product** *required*

The exchanged-for product.

**quantity** `Int!` *required*

The exchanged quantity.

**variant** *required*

The exchanged-for variant.

**externalIdentifier** `String`

A merchant-set external identifier for the item.

**externalReturnLineItemId** `String`

The external return line item id, if any.

**grade** `String`

The merchant-assigned grade.

**greenReturn** `Boolean`

Whether the item is a green (keep-it) return.

**id** `ID!` *required*

The return item id.

**multipleChoiceQuestions** *required*

Multiple-choice question answers for the item.

**fields**

**answer** `String!` *required*

The chosen answer.

**question** `String!` *required*

The question.

**orderLineItemId** `String`

The id of the order line item this return item came from.

**outcome** `String`

The merchant-assigned processing outcome.

**processingImages** `[String!]!` *required*

Merchant-uploaded processing images.

**processingNotes** `String`

Merchant processing notes.

**productAdjustment** `String`

The merchant price adjustment for the item.

**productId** `String`

The item's product id.

**productValue** *required*

The item's product value: the per-item price after discounts, before tax and merchant adjustments.

**fields**

**amount** *required*

The exact amount as a decimal string (e.g. "19.99").

**currency** `String!` *required*

ISO 4217 currency code (e.g. USD).

**quantity** `Int!` *required*

The returned quantity.

**reason** `String`

The return reason.

**reasonCode** `String`

The return reason code.

**reasonCodes** `[String!]!` *required*

All return reason codes.

**reasonConversation**

The conversation Redo had with the shopper to find their return reason. Null if the item did not go through the conversational return reason flow.

**fields**

**messages** *required*

The messages the shopper saw, in order.

**summary** `String`

Generated summary of the conversation. Null until it has been generated.

**reasons** `[String!]!` *required*

All return reasons.

**refund** *required*

The refund for this item.

**fields**

**amount** *required*

The refunded amount for the item.

**type**

The compensation strategy (null for exchanges).

**sku** `String`

The item's SKU.

**status**

The item's processing status.

**upc** `String`

The item's barcode/UPC.

**variantId** `String`

The item's variant id.

**shipment**

The shipment fulfilling this group, if a label exists.

**Requires:** [`returns_read`](/docs/api-reference/v3/reference/scopes#scope-returns_read)

**fields**

**carrier** `String`

The carrier.

**deliveredAt**

When the shipment was delivered, if it has been.

**estimatedDeliveryDate**

The carrier's estimated delivery date, if any.

**formLabel** `String`

A URL to the customs/return form, if any.

**id** `ID!` *required*

The id of this shipment.

**postageLabel** `String`

A URL to the postage label, if any.

**status** `String`

The tracking status.

**tracker** `String`

The tracking code.

**trackingUrl** `String`

A public tracking URL.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.