Query SP Fee Details with the GraphQL Admin API
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on September 23, 2026.
This Shopify update is categorized as API, New, Admin GraphQL API, 2026-10.
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.
Who is 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.
What action may be needed
To use the feeDetails: Use GraphQL Admin API version 2026-10 or later. Confirm that your app has the read_billing access scope. Query feeDetails and select the fields you need on each FeeDetails node Related docs feeDetails query reference FeeDetails object reference GraphQL Admin API reference for 2026-10
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →