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

# returnShippingOptions

> The store's return shipping options: the cap on what a return label can cost, when a signature is required, whether a label's cost is deducted from a refund, store credit or exchange, and whether labels combine only across one fulfillment.

**Required scopes:** [`returns_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-returns_read)

## Returns

**returnShippingOptions** `[ReturnShippingOptions!](/docs/api-reference/v3/reference/returns/return-shipping-options)` *required*

How the store buys and charges for return shipping labels: the most it will pay for one, when a signature is required, what a label's cost is deducted from, and how items share a label. These are the settings on the merchant app's shipping and returns pages. Several of them change what a label costs the store or what a customer is paid.

**fields**

**deductLabelFromCredit** `Boolean!` *required*

Whether the cost of the return label is subtracted from the store credit the customer receives. Changes what customers are paid out.

**deductLabelFromExchange** `Boolean!` *required*

Whether the cost of the return label is subtracted from the value applied to an exchange.

**deductLabelFromRefund** `Boolean!` *required*

Whether the cost of the return label is subtracted from the customer's refund. Changes what customers are paid out.

**merchantMaxLabelPrice** `[Money](/docs/api-reference/v3/reference/common/money)`

The most Redo will pay for one return label when the store is the one paying for it. Null means Redo's default cap applies. Customer-paid and Redo-paid labels have their own caps, so this does not affect them. Always in USD.

**fields**

**amount** `[Decimal!](/docs/api-reference/v3/reference/common/decimal)` *required*

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

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

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

**onlyCombineLabelsFromSameFulfillment** `Boolean!` *required*

Whether items share one return label only when they shipped in the same original fulfillment. When false, items from different fulfillments can share a label, which costs less but mixes shipments.

**requireSignature** `Boolean!` *required*

Whether a return shipment needs a signature on delivery when the returned items are worth at least `requireSignatureThreshold`. Signature delivery costs more per label. Has no effect while the threshold is null.

**requireSignatureForTags** `Boolean!` *required*

Whether a return shipment needs a signature on delivery when it contains a product with one of `requireSignatureTags`. Signature delivery costs more per label.

**requireSignatureTags** `[String!]!` *required*

Product tags that require a signature when `requireSignatureForTags` is on. Matched without regard to case.

**requireSignatureThreshold** `[Money](/docs/api-reference/v3/reference/common/money)`

The returned items' total value at or above which a signature is required, when `requireSignature` is on. Null means no value triggers it. Always in USD.

**fields**

**amount** `[Decimal!](/docs/api-reference/v3/reference/common/decimal)` *required*

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

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

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

## Example

```graphql theme={null}
query {
  returnShippingOptions {
    deductLabelFromCredit
    deductLabelFromExchange
    deductLabelFromRefund
    onlyCombineLabelsFromSameFulfillment
    requireSignature
    requireSignatureForTags
    requireSignatureTags
  }
}
```


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