How to get the date of a shipping refund

Retired Boards Appdev Graphql Basics And Troubleshooting

Topic summary

Goal: retrieve the date when a shipping refund was issued via the Shopify GraphQL Admin API.

Current state (stable API): no dedicated field exists to identify the date of a shipping refund. Refunds and transactions expose createdAt timestamps, but these do not indicate whether they correspond to a shipping refund specifically.

Workaround (unstable API): the refund’s OrderAdjustment object includes a SHIPPING_REFUND value, which can help identify shipping-related adjustments (similar to REST). This may enable associating a createdAt with shipping refunds, but it is only available in the unstable version.

Open items: a user requested an ETA for this capability in the stable API to support detailed invoicing. No timeline or commitment was provided.

Status: unresolved/ongoing; stable API lacks a direct way to get shipping refund dates, with a potential path via the unstable API’s OrderAdjustment.SHIPPING_REFUND.

Summarized with AI on December 23. AI used: gpt-5.
1

I do have a GraphQL query which looks like the following to get the Shipping Refund amount of an Order:

{
  order(id:"gid://shopify/Order/5505750073611") {
    totalRefundedShippingSet {
        shopMoney {
            amount
        }
    }
  }
}

Is there any property in the GraphQL Admin API to get the date when the shipping refund was issued?
For normal refunds, this works seamlessly with the createdAt property. Unfortunately I could not find such a property for shipping refunds.

Thanks a lot in advance!

2

Hi @KevinSchade ,

At this time, there is no specific field on any of the stable versions of the API to confirm an order’s refunded-shipping date(s).

Both an order’s refunds and transactions will have createdAt DateTime objects, but neither of those specify if they come from a shipping refund in the stable versions of the GraphQL Admin API.

The unstable version does currently has a SHIPPING_REFUND value on the refund’s OrderAdjustment object, which is closer to how these could be identified with the REST Admin API and might be useful for you.

All the best

3

Hi @ShopifyDevSup ,

When do you think this will become available for the stable version? It is very hard to create a detailed invoice when missing this option.

Kind regards,

Glenn