---
title: Access transactions on the Return object - Shopify developer changelog
description: Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities.
source_url:
  html: https://shopify.dev/changelog/access-transactions-on-the-return-object
  md: https://shopify.dev/changelog/access-transactions-on-the-return-object.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

January 1, 2026

Tags:

* Admin GraphQL API
* 2026-01

# Access transactions on the Return object

You can now access transaction data directly from the `Return` object in the Admin GraphQL API. This new `transactions` connection simplifies your ability to associate payments and refunds with specific returns, removing the need to deduce relationships based on amounts and timestamps. This helps ensure accurate financial reporting and reconciliation for integrations.

The `transactions` connection is populated for the following scenarios:

* **POS returns and exchanges**: Includes both refunds and captured payments.
* **Online returns and exchanges**: Includes refunds only.

Here's an example of how to query transactions on a return:

```graphql
query {
  return(id: "gid://shopify/Return/123") {
    transactions(first: 5) {
      edges {
        node {
          id
          kind
          status
          amountSet {
            shopMoney {
              amount
              currencyCode
            }
          }
        }
      }
    }
  }
}
```

For more details, refer to the [Return object documentation](https://shopify.dev/docs/api/admin-graphql/latest/queries/return?#returns-Return.fields.transactions).