Skip to main content

Query SP Fee Details with the GraphQL Admin API

As of API version 2026-10, the GraphQL Admin API includes a feeDetails query for retrieving specialized fees charged to a shop.

No action is required for existing apps.

What changed

The new feeDetails query returns a connection of 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 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

Was this page helpful?