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

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

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

* 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).

***

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

***

## <\~> 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)