HI All, 

We are currently facing an issue with one of our finance payment method providers is setting declined orders in "EXPIRED" state, but this state is NOT VISIBLE via REST API ( orders there are still visible as Pending .


I asked Shopify AI about it and got that response:

The REST API's financial_status field in the Order endpoint stays as "PENDING" and doesn't show "EXPIRED". Let me search for information about where expired status information is available in Shopify's APIs. Perfect! I found the exact information you need. Based on the documentation, you're correct that the REST API's financial_status field stays as "PENDING" for expired orders. However, there is a way to get the expired status information.

The solution is to use the Admin GraphQL API instead of REST API.

In the Admin GraphQL API, you can access the displayFinancialStatus field on the Order object, which includes EXPIRED as one of its enum values:

GraphQL field: displayFinancialStatus Enum values include:

• AUTHORIZED
• EXPIRED ← This is what you need
• PAID
• PARTIALLY_PAID
• PARTIALLY_REFUNDED
• PENDING
• REFUNDED
• VOIDED

Why this difference exists:

• The REST API's financial_status field appears to maintain backward compatibility and shows "PENDING" for expired authorizations
• The GraphQL API's displayFinancialStatus field provides more granular status information, including the "EXPIRED" state

To get expired order information, you would need to:

1. Use the Admin GraphQL API instead of REST API
2. Query the displayFinancialStatus field on orders
3. Filter for orders where displayFinancialStatus equals EXPIRED

This is the only reliable way to programmatically identify expired orders through Shopify's APIs.


Will it be possible to add displayFinancialStatus to orders table?