---
title: Return - Customer API
description: A product return.
api_version: 2025-10
api_name: customer
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/objects/return
  md: https://shopify.dev/docs/api/customer/latest/objects/return.md
---

# Return

object

A product return.

## Fields

* closed​At

  [Date​Time](https://shopify.dev/docs/api/customer/latest/scalars/DateTime)

  [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  The date when the return was closed.

* created​At

  [Date​Time](https://shopify.dev/docs/api/customer/latest/scalars/DateTime)

  The date when the return was created.

* exchange​Line​Items

  [Exchange​Line​Item​Connection!](https://shopify.dev/docs/api/customer/latest/connections/ExchangeLineItemConnection)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  The exchange line items attached to the return.

  * include​Removed​Items

    [Boolean](https://shopify.dev/docs/api/customer/latest/scalars/Boolean)

    Default:false

    ### Arguments

    Include exchange line items that have been removed from the order by an order edit, return, etc. Items that have been removed have a zero ([LineItem.currentQuantity](https://shopify.dev/docs/api/admin-graphql/unstable/objects/LineItem#field-lineitem-currentquantity)).

  * first

    [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int)

    The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * after

    [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

    The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * last

    [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int)

    The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * before

    [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

    The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * reverse

    [Boolean](https://shopify.dev/docs/api/customer/latest/scalars/Boolean)

    Default:false

    Reverse the order of the underlying list.

  ***

* id

  [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  A globally-unique ID.

* name

  [String!](https://shopify.dev/docs/api/customer/latest/scalars/String)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  The name assigned to the return.

* return​Line​Items

  [Return​Line​Item​Type​Connection!](https://shopify.dev/docs/api/customer/latest/connections/ReturnLineItemTypeConnection)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  The line items associated with the return.

  * first

    [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int)

    ### Arguments

    The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * after

    [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

    The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * last

    [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int)

    The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * before

    [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

    The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * reverse

    [Boolean](https://shopify.dev/docs/api/customer/latest/scalars/Boolean)

    Default:false

    Reverse the order of the underlying list.

  ***

* return​Line​Items​Count

  [Count](https://shopify.dev/docs/api/customer/latest/objects/Count)

  [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  The number of line items associated with the return.

* reverse​Deliveries

  [Reverse​Delivery​Connection!](https://shopify.dev/docs/api/customer/latest/connections/ReverseDeliveryConnection)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  The list of reverse deliveries associated with the return.

  * first

    [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int)

    ### Arguments

    The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * after

    [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

    The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * last

    [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int)

    The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * before

    [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

    The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * reverse

    [Boolean](https://shopify.dev/docs/api/customer/latest/scalars/Boolean)

    Default:false

    Reverse the order of the underlying list.

  ***

* status

  [Return​Status!](https://shopify.dev/docs/api/customer/latest/enums/ReturnStatus)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  The current status of the `Return`.

* updated​At

  [Date​Time](https://shopify.dev/docs/api/customer/latest/scalars/DateTime)

  The date when the return was last updated.

***

## Map

### Fields and connections with this object

* {}[Order.returns](https://shopify.dev/docs/api/customer/latest/objects/Order#field-Order.fields.returns)
* {}[ReturnAgreement.return](https://shopify.dev/docs/api/customer/latest/objects/ReturnAgreement#field-ReturnAgreement.fields.return)
* <->[ReturnConnection.nodes](https://shopify.dev/docs/api/customer/latest/connections/ReturnConnection#returns-nodes)
* {}[ReturnEdge.node](https://shopify.dev/docs/api/customer/latest/objects/ReturnEdge#field-ReturnEdge.fields.node)

***

## Queries

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

  query

  Returns a Return resource by ID. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data).

  * id

    [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

    required

    ### Arguments

    The ID of the Return.

  ***

***

## \<?>Return Queries

### Queried by

* \<?>[return](https://shopify.dev/docs/api/customer/latest/queries/return)

***

## Mutations

* [order​Request​Return](https://shopify.dev/docs/api/customer/latest/mutations/orderRequestReturn)

  mutation

  Request a new return on behalf of a customer.

  * order​Id

    [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

    required

    ### Arguments

    The ID of the order for which this return is being requested.

  * requested​Line​Items

    [\[Requested​Line​Item​Input!\]!](https://shopify.dev/docs/api/customer/latest/input-objects/RequestedLineItemInput)

    required

    The line items that are requested to be returned.

  ***

***

## <\~> Return Mutations

### Mutated by

* <\~>[order​Request​Return](https://shopify.dev/docs/api/customer/latest/mutations/orderRequestReturn)

***

## Interfaces

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

  interface

***

## ||-Return Implements

### Implements

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