Balance Transactions by Payout ID

GraphQL Admin API Troubleshooting
1

Hi,

I am migrating from REST to Graph QL.

I need to query a list of balance transactions by payout ID:

/admin/api/2025-10/shopify_payments/balance/transactions.json?payout_id=

It appears the graph API does not allow me to pull transactions by payout ID. Is there a workaround? Will Shopify add this endpoint?

Will this Graph QL query allow us to query balance transactions by payout ID?

1 Like
2

Hey @Joseph_Anderson,

Currently, the balanceTransactions query doesn’t include payout_id as one of its available search filters.

You can work around this by using the available filters like payout_date and payout_status to narrow down your results, then filter client-side by checking the associatedPayout.id field in the response.

3

@KyleG-Shopify Is this confirming that the payments_transfer_id filter won’t work? Or is it not meant to be used in this way?

4

@SRCB our app use this filter for this purpose and I can confirm this works as expected.

See below for a sample query;

{
shopifyPaymentsAccount
{
balanceTransactions(first: 250 after: null query: “payout_date:{{payoutDate:yyyy-MM-ddTHH:mm:ss}}Z payments_transfer_id:{{payoutId}}”)
{
nodes
{
id
associatedPayout {
id
}
}
pageInfo
{
hasNextPage
endCursor
}
}
}
}

5

Thanks for clarifying that Mathieu. I’ll pass on some feedback to clarify this filter in our docs.