---
title: return - Customer API
description: |-
  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).
api_version: 2026-07
source_url:
  html: https://shopify.dev/docs/api/customer/latest/queries/Return
  md: https://shopify.dev/docs/api/customer/latest/queries/Return.md
---

# return

query

Requires `customer_read_pre_authenticated` access scope. Also: Available in an pre-authenticated state or fully authenticated state with a valid return id.

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

## Arguments

* id

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

  required

  The ID of the Return.

***

## Possible returns

* Return

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

  A product return.

  * closed​At

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

    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

    The exchange line items attached to the return.

    * after

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

      ### Arguments

      The elements that come after the specified [cursor](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).

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

    * include​Removed​Items

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

      Default:false

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

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

    * 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

    A globally-unique ID.

  * name

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

    non-null

    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

    The line items associated with the return.

    * after

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

      ### Arguments

      The elements that come after the specified [cursor](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).

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

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

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

    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

    The list of reverse deliveries associated with the return.

    * after

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

      ### Arguments

      The elements that come after the specified [cursor](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).

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

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

    * 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

    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.

***

## Examples

* ### return reference