---
title: orderRequestReturn - Customer API
description: Request a new return on behalf of a customer.
api_version: 2025-10
api_name: customer
type: mutation
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/customer/latest/mutations/orderRequestReturn'
  md: 'https://shopify.dev/docs/api/customer/latest/mutations/orderRequestReturn.md'
---

# order​Request​Return

mutation

Request a new return on behalf of a customer.

## Arguments

* order​Id

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

  required

  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.

***

## Order​Request​Return​Payload returns

* return

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

  The return request that has been made.

* user​Errors

  [\[Return​User​Error!\]!](https://shopify.dev/docs/api/customer/latest/objects/ReturnUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### orderRequestReturn reference

## Mutation Reference

```graphql
mutation orderRequestReturn($orderId: ID!, $requestedLineItems: [RequestedLineItemInput!]!) {
  orderRequestReturn(orderId: $orderId, requestedLineItems: $requestedLineItems) {
    return {
      # Return fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

##### Variables

```json
{
  "orderId": "gid://shopify/<objectName>/10079785100",
  "requestedLineItems": [
    {
      "lineItemId": "gid://shopify/<objectName>/10079785100",
      "quantity": 1,
      "returnReason": "SIZE_TOO_SMALL",
      "customerNote": "<your-customerNote>"
    }
  ]
}
```

##### Schema

```graphql
input RequestedLineItemInput {
  lineItemId: ID!
  quantity: Int!
  returnReason: ReturnReason!
  customerNote: String
}
```