---
title: SuggestedRefund - GraphQL Admin
description: Represents a refund suggested by Shopify based on the items being reimbursed. You can then use the suggested refund object to generate an actual refund.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/suggestedrefund
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/suggestedrefund.md
---

# Suggested​Refund

object

Requires `read_orders` access scope or `read_marketplace_orders` access scope.

Represents a refund suggested by Shopify based on the items being reimbursed. You can then use the suggested refund object to generate an actual refund.

## Fields

* amount​Set

  [Money​Bag!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyBag)

  non-null

  The total monetary value to be refunded in shop and presentment currencies.

* discounted​Subtotal​Set

  [Money​Bag!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyBag)

  non-null

  The sum of all the discounted prices of the line items being refunded.

* maximum​Refundable​Set

  [Money​Bag!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyBag)

  non-null

  The total monetary value available to refund in shop and presentment currencies.

* refund​Duties

  [\[Refund​Duty!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/RefundDuty)

  non-null

  A list of duties to be refunded from the order.

* refund​Line​Items

  [\[Refund​Line​Item!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/RefundLineItem)

  non-null

  A list of line items to be refunded, along with restock instructions.

* shipping

  [Shipping​Refund!](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShippingRefund)

  non-null

  The shipping costs to be refunded from the order.

* subtotal​Set

  [Money​Bag!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyBag)

  non-null

  The sum of all the prices of the line items being refunded in shop and presentment currencies.

* suggested​Refund​Methods

  [\[Suggested​Refund​Method!\]!](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/SuggestedRefundMethod)

  non-null

  A list of suggested refund methods.

* suggested​Transactions

  [\[Suggested​Order​Transaction!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/SuggestedOrderTransaction)

  non-null

  A list of suggested order transactions.

* total​Cart​Discount​Amount​Set

  [Money​Bag!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyBag)

  non-null

  The total cart discount amount that was applied to all line items in this refund.

* total​Duties​Set

  [Money​Bag!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyBag)

  non-null

  The sum of all the duties being refunded from the order in shop and presentment currencies. The value must be positive.

* total​Tax​Set

  [Money​Bag!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyBag)

  non-null

  The sum of the taxes being refunded from the order in shop and presentment currencies. The value must be positive.

### Deprecated fields

* amount

  [Money!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Money)

  non-nullDeprecated

* maximum​Refundable

  [Money!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Money)

  non-nullDeprecated

* subtotal

  [Money!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Money)

  non-nullDeprecated

* total​Taxes

  [Money!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Money)

  non-nullDeprecated

***

## Map

### Fields with this object

* {}[Order.suggestedRefund](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-suggestedRefund)