---
title: ExchangeV2 - GraphQL Admin
description: An exchange where existing items on an order are returned and new items are added to the order.
api_version: 2026-04
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/ExchangeV2
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/ExchangeV2.md
---

# Exchange​V2

object

Requires `read_orders` access scope. Also: You must have permissions for `orders` and `better_exchanges`.

An exchange where existing items on an order are returned and new items are added to the order.

## Fields

* additions

  [Exchange​V2Additions!](https://shopify.dev/docs/api/admin-graphql/latest/objects/ExchangeV2Additions)

  non-null

  The details of the new items in the exchange.

* completed​At

  [Date​Time](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  The date and time when the exchange was completed.

* created​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  non-null

  The date and time when the exchange was created.

* id

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

  non-null

  A globally-unique ID.

* location

  [Location](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location)

  The location where the exchange happened.

* mirrored

  [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  non-null

  Mirrored from Admin Exchanges.

* note

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The text of an optional note that a shop owner can attach to the exchange.

* refunds

  [\[Refund!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/Refund)

  non-null

  The refunds processed during the exchange.

* returns

  [Exchange​V2Returns!](https://shopify.dev/docs/api/admin-graphql/latest/objects/ExchangeV2Returns)

  non-null

  The details of the returned items in the exchange.

* staff​Member

  [Staff​Member](https://shopify.dev/docs/api/admin-graphql/latest/objects/StaffMember)

  The staff member associated with the exchange.

* total​Amount​Processed​Set

  [Money​Bag!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyBag)

  non-null

  The amount of money that was paid or refunded as part of the exchange.

* total​Price​Set

  [Money​Bag!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyBag)

  non-null

  The difference in values of the items that were exchanged.

* transactions

  [\[Order​Transaction!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderTransaction)

  non-null

  The order transactions related to the exchange.

***

## Map

### Fields and connections with this object

* [ExchangeV2Connection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/ExchangeV2Connection#returns-nodes)
* [ExchangeV2Edge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/ExchangeV2Edge#field-ExchangeV2Edge.fields.node)

***

## Interfaces

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)

  interface

***

## ExchangeV2 Implements

### Implements

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)