---
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: 2025-07
api_name: customer
type: query
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/customer/2025-07/queries/return'
  md: 'https://shopify.dev/docs/api/customer/2025-07/queries/return.md'
---

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

## Arguments

* id

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

  required

  The ID of the Return.

***

## Possible returns

* Return

  [Return](https://shopify.dev/docs/api/customer/2025-07/objects/Return)

  A product return.

  * closed​At

    [Date​Time](https://shopify.dev/docs/api/customer/2025-07/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/2025-07/scalars/DateTime)

    The date when the return was created.

  * exchange​Line​Items

    [Exchange​Line​Item​Connection!](https://shopify.dev/docs/api/customer/2025-07/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/2025-07/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/2025-07/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/2025-07/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/2025-07/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/2025-07/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/2025-07/scalars/Boolean)

      Default:false

      Reverse the order of the underlying list.

    ***

  * id

    [ID!](https://shopify.dev/docs/api/customer/2025-07/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/2025-07/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/2025-07/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/2025-07/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/2025-07/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/2025-07/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/2025-07/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/2025-07/scalars/Boolean)

      Default:false

      Reverse the order of the underlying list.

    ***

  * return​Line​Items​Count

    [Count](https://shopify.dev/docs/api/customer/2025-07/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/2025-07/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/2025-07/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/2025-07/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/2025-07/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/2025-07/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/2025-07/scalars/Boolean)

      Default:false

      Reverse the order of the underlying list.

    ***

  * status

    [Return​Status!](https://shopify.dev/docs/api/customer/2025-07/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/2025-07/scalars/DateTime)

    The date when the return was last updated.

***

## Examples

* ### return reference