--- title: Return - Customer API description: A product return. api_version: 2025-04 api_name: customer type: object api_type: graphql source_url: html: 'https://shopify.dev/docs/api/customer/2025-04/objects/Return' md: 'https://shopify.dev/docs/api/customer/2025-04/objects/Return.md' --- # Return object A product return. ## Fields * closed​At [Date​Time](https://shopify.dev/docs/api/customer/2025-04/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-04/scalars/DateTime) The date when the return was created. * id [ID!](https://shopify.dev/docs/api/customer/2025-04/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-04/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-04/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-04/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-04/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-04/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-04/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-04/scalars/Boolean) Default:false Reverse the order of the underlying list. *** * return​Line​Items​Count [Count](https://shopify.dev/docs/api/customer/2025-04/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-04/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-04/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-04/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-04/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-04/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-04/scalars/Boolean) Default:false Reverse the order of the underlying list. *** * status [Return​Status!](https://shopify.dev/docs/api/customer/2025-04/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-04/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/2025-04/objects/Order#field-Order.fields.returns) * [ReturnAgreement.return](https://shopify.dev/docs/api/customer/2025-04/objects/ReturnAgreement#field-ReturnAgreement.fields.return) * [ReturnConnection.nodes](https://shopify.dev/docs/api/customer/2025-04/connections/ReturnConnection#returns-nodes) * [ReturnEdge.node](https://shopify.dev/docs/api/customer/2025-04/objects/ReturnEdge#field-ReturnEdge.fields.node) *** ## Queries * [return](https://shopify.dev/docs/api/customer/2025-04/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/2025-04/scalars/ID) required ### Arguments The ID of the Return. *** *** ## Return Queries ### Queried by * [return](https://shopify.dev/docs/api/customer/2025-04/queries/return) *** ## Mutations * [order​Request​Return](https://shopify.dev/docs/api/customer/2025-04/mutations/orderRequestReturn) mutation Request a new return on behalf of a customer. * order​Id [ID!](https://shopify.dev/docs/api/customer/2025-04/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/2025-04/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/2025-04/mutations/orderRequestReturn) *** ## Interfaces * [Node](https://shopify.dev/docs/api/customer/2025-04/interfaces/Node) interface *** ## Return Implements ### Implements * [Node](https://shopify.dev/docs/api/customer/2025-04/interfaces/Node)