> ## Documentation Index
> Fetch the complete documentation index at: https://docs-test.rye.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# returnByID

> Returns a ReturnOrder object by ID. This query can be used to retrieve information about the individual return request.

***

### Arguments

<ParamField path="input" type={<><a href="/api-reference/returnbyidinput">ReturnByIdInput!</a></>} required>
  The input object. See [ReturnByIdInput](/api-reference/returnbyidinput).
</ParamField>

### Returns

<ParamField path="ReturnOrder.*" type={<><a href="/api-reference/returnOrder">ReturnOrder</a></>}>
  Any requested field from the [`ReturnOrder`](/api-reference/returnorder-object) object.
</ParamField>

***

### Example - request

```json Query arguments theme={null}
{
    "input":{
        "orderId": "b380dcf1-1d68-48c7-b70c-ff0f7d63bcf5",
        "returnId": "cdb475e6-466d-4def-a5fa-602e1fa7d8e3"
    }
}
```

```GraphQL GraphQL theme={null}
query ReturnById($input: ReturnByIdInput!) {
  returnByID(input: $input) {
    ...on ReturnAmazon {
        marketplace
        amazonOrderId
        lineItems {
            status
            productId
            quantity
        }
    }
    ...on ReturnShopify {
        marketplace
        orderId
        lineItems {
            status
            variantId
            quantity
            currencyCode
            price
        }
    }
  }
}
```

### Example - response

```json Response theme={null}
{
    "data": {
        "returnByID": {
            "marketplace": "SHOPIFY",
            "orderId": "5776005693737",
            "lineItems": [
                {
                    "status": "RETURN_CLOSED",
                    "variantId": "46579981844777",
                    "quantity": 1,
                    "currencyCode": "USD",
                    "price": "24.99"
                }
            ]
        }
    }
}
```

***