---
title: Query SP Fee Details with the GraphQL Admin API - 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/query-sp-fee-details-with-the-graphql-admin-api
  md: >-
    https://shopify.dev/changelog/query-sp-fee-details-with-the-graphql-admin-api.md
metadata:
  effectiveApiVersion: 2026-10
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-09-22T16:16:31-04:00'
  postedAt: '2026-09-23T12:00:00-04:00'
  updatedAt: '2026-09-25T11:48:48-04:00'
  effectiveAt: '2026-09-23T12:00:00-04:00'
---

September 23, 2026

# Query SP Fee Details with the GraphQL Admin API

DateSeptember 23, 2026

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

FlagsNew

SurfacesAPI

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

As of API version 2026-10, the GraphQL Admin API includes a [`feeDetails` query](https://shopify.dev/docs/api/admin-graphql/2026-10/queries/feeDetails) for retrieving specialized fees charged to a shop.

No action is required for existing apps.

## What changed

The new [`feeDetails`](https://shopify.dev/docs/api/admin-graphql/2026-10/queries/feeDetails) query returns a connection of [`FeeDetails`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/FeeDetails) objects. Each `FeeDetails` object includes:

* `feeName` and `amount`: The name of the fee and the amount charged.
* `flatRate` and `variableRate`: The fixed amount and the rate that make up the fee.
* `taxAmount`: The tax charged on the fee.
* `settlementAmount` and `settlementCurrencyRate`: The fee in its settlement currency and the exchange rate used to convert it.
* `orderTransaction`: The [`OrderTransaction`](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/OrderTransaction) the fee was charged on, if any.
* `createdAt` and `processedAt`: When the fee was recorded and when it was processed.

This change is additive and doesn't alter any existing field in the Admin API.

## Who's affected

This change applies to apps that use GraphQL Admin API version 2026-10 or later and need to retrieve specialized fees recorded on a store's transactions. App that use earlier version or that don't work with Shopify Payments fees are unaffected. A store with no recorded fee details returns an empty connection rather than an error.

## Why this matters

You can retrieve the individual fees recorded on a store's transactions and match each one to its order transaction, instead of working from aggregated fee amounts.

## What to do

To use the `feeDetails`:

1. Use GraphQL Admin API version 2026-10 or later.
2. Confirm that your app has the `read_billing` access scope.
3. Query `feeDetails` and select the fields you need on each `FeeDetails` node

## Related docs

* [feeDetails query reference](https://shopify.dev/docs/api/admin-graphql/2026-10/queries/feeDetails)
* [FeeDetails object reference](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/FeeDetails)
* [GraphQL Admin API reference for 2026-10](https://shopify.dev/docs/api/admin-graphql/2026-10)