---
title: returnCalculate - GraphQL Admin
description: |-
  Calculates the financial outcome of a [`Return`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Return) without creating it. Use this query to preview return costs before initiating the actual return process.

  The calculation provides detailed breakdowns of refund amounts, taxes, [`RestockingFee`](https://shopify.dev/docs/api/admin-graphql/latest/objects/RestockingFee) charges, return shipping fees, and order-level discount adjustments based on the [`FulfillmentLineItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentLineItem) objects that customers select for return.

  Learn more about building for [return management](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/build-return-management).
api_version: 2025-10
api_name: admin
type: query
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/queries/returncalculate
  md: https://shopify.dev/docs/api/admin-graphql/latest/queries/returncalculate.md
---

# return​Calculate

query

Requires `read_returns` access scope or `read_marketplace_returns` access scope. Also: The shop must have access to exchanges.

Calculates the financial outcome of a [`Return`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Return) without creating it. Use this query to preview return costs before initiating the actual return process.

The calculation provides detailed breakdowns of refund amounts, taxes, [`RestockingFee`](https://shopify.dev/docs/api/admin-graphql/latest/objects/RestockingFee) charges, return shipping fees, and order-level discount adjustments based on the [`FulfillmentLineItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentLineItem) objects that customers select for return.

Learn more about building for [return management](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/build-return-management).

## Arguments

* input

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

  required

  The input fields for calculating a return.

***

## Possible returns

* Calculated​Return

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

  A calculated return.

***

## Examples

* ### returnCalculate reference

## Query Reference

```graphql
{
  returnCalculate(input) {
    # returnCalculate fields
  }
}
```