---
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/posts/access-transactions-on-the-return-object'
  md: >-
    https://shopify.dev/changelog/posts/access-transactions-on-the-return-object.md
metadata:
  effectiveApiVersion: 2026-01
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2026-01-12T15:14:15-05:00'
  postedAt: '2026-01-01T12:00:00-05:00'
  updatedAt: '2026-01-12T16:31:10-05:00'
  effectiveAt: '2026-01-01T12:00:00-05:00'
---

January 1, 2026

# Access transactions on the Return object

DateJanuary 1, 2026

Version[2026-01](https://shopify.dev/changelog?api_version=2026-01)

FlagsUpdate

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)

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).