---
title: Return - GraphQL Admin
description: >-
  The `Return` object represents the intent of a buyer to ship one or more items
  from an order back to a merchant

  or a third-party fulfillment location. A return is associated with an
  [order](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order)

  and can include multiple return [line
  items](https://shopify.dev/docs/api/admin-graphql/latest/objects/LineItem).

  Each return has a
  [status](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps#return-statuses),

  which indicates the state of the return.


  Use the `Return` object to capture the financial, logistical,

  and business intent of a return. For example, you can identify eligible items
  for a return and issue customers

  a refund for returned items on behalf of the merchant.


  Learn more about providing a

  [return management
  workflow](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/build-return-management)

  for merchants. You can also manage
  [exchanges](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/manage-exchanges),

  [reverse fulfillment
  orders](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/manage-reverse-fulfillment-orders),

  and [reverse
  deliveries](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/manage-reverse-deliveries)

  on behalf of merchants.
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Return'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Return.md'
---

# Return

object

Requires `read_returns` access scope or `read_marketplace_returns` access scope.

The `Return` object represents the intent of a buyer to ship one or more items from an order back to a merchant or a third-party fulfillment location. A return is associated with an [order](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) and can include multiple return [line items](https://shopify.dev/docs/api/admin-graphql/latest/objects/LineItem). Each return has a [status](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps#return-statuses), which indicates the state of the return.

Use the `Return` object to capture the financial, logistical, and business intent of a return. For example, you can identify eligible items for a return and issue customers a refund for returned items on behalf of the merchant.

Learn more about providing a [return management workflow](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/build-return-management) for merchants. You can also manage [exchanges](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/manage-exchanges), [reverse fulfillment orders](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/manage-reverse-fulfillment-orders), and [reverse deliveries](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/manage-reverse-deliveries) on behalf of merchants.

## Fields

* closedAt
* createdAt
* decline
* exchangeLineItems
* id
* name
* order
* refunds
* requestApprovedAt
* returnLineItems
* returnShippingFees
* reverseFulfillmentOrders
* staffMember
* status
* suggestedFinancialOutcome
* totalQuantity
* transactions
* suggestedRefund: deprecated

***

## Map

### Fields and connections with this object

* [Order.returns](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.returns)
* [Refund.return](https://shopify.dev/docs/api/admin-graphql/latest/objects/Refund#field-Refund.fields.return)
* [ReturnAgreement.return](https://shopify.dev/docs/api/admin-graphql/latest/objects/ReturnAgreement#field-ReturnAgreement.fields.return)
* [ReturnConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/ReturnConnection#returns-nodes)
* [ReturnEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/ReturnEdge#field-ReturnEdge.fields.node)

***

## Queries

* return

***

## Return Queries

### Queried by

* [return](https://shopify.dev/docs/api/admin-graphql/latest/queries/return)

***

## Mutations

* removeFromReturn
* returnApproveRequest
* returnCancel
* returnClose
* returnCreate
* returnDeclineRequest
* returnProcess
* returnReopen
* returnRequest
* returnLineItemRemoveFromReturn: deprecated

***

## Return Mutations

### Mutated by

* [remove​From​Return](https://shopify.dev/docs/api/admin-graphql/latest/mutations/removeFromReturn)
* [return​Approve​Request](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnApproveRequest)
* [return​Cancel](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnCancel)
* [return​Close](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnClose)
* [return​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnCreate)
* [return​Decline​Request](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnDeclineRequest)
* [return​Process](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnProcess)
* [return​Reopen](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnReopen)
* [return​Request](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnRequest)

***

## Interfaces

* Node

***

## Return Implements

### Implements

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)