# Filter orders by return status — Shopify developer changelog
---
## Filter orders by return status

You can now filter orders by their return status.

The [`return_status` filter](https://shopify.dev/docs/api/admin-graphql/2023-04/queries/orders#:~:text=reference_location_id-,return_status,-risk_level) is available on the orders connection. This status corresponds to the return status merchants see in the orders page.

Learn more about the order's return status on [Shopify.dev](https://shopify.dev/docs/api/admin-graphql/2023-04/enums/OrderReturnStatus).

Learn more about return statuses on [the help center](https://help.shopify.com/en/manual/orders/order-status#return-status).

*Published: April 01, 2023*
Tags: API, New
Link: https://shopify.dev/changelog/filter-orders-by-return-status

---