---
title: returnCalculate - Customer API
description: The calculated monetary value of the return.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/customer/latest/queries/returnCalculate'
  md: 'https://shopify.dev/docs/api/customer/latest/queries/returnCalculate.md'
api_name: customer
api_type: graphql
type: query
---

# return​Calculate

query

Requires `customer_read_orders` access scope.

The calculated monetary value of the return.

## Arguments

* input

  [Calculate​Return​Input!](https://shopify.dev/docs/api/customer/latest/input-objects/CalculateReturnInput)

  required

  The input fields for calculating a return.

***

## Possible returns

* Calculated​Return

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

  The calculated financial outcome of a return based on the line items requested for return.Includes the monetary values of the line items, along with applicable taxes, discounts, and otherfees on the order. Financial summary may include return fees depending onthe [return rules](https://help.shopify.com/manual/fulfillment/managing-orders/returns/return-rules)at the time the order was placed.

  * financial​Summary

    [Return​Financial​Summary!](https://shopify.dev/docs/api/customer/latest/objects/ReturnFinancialSummary)

    non-null

    A breakdown of the monetary values for the calculated return.

  * return​Line​Items

    [Calculated​Return​Line​Item​Connection!](https://shopify.dev/docs/api/customer/latest/connections/CalculatedReturnLineItemConnection)

    non-null

    A list of line items being processed for a 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.

    ***

***

## Examples

* ### returnCalculate reference