---
title: Filter orders by return status - Shopify developer changelog
description: Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities.
source_url:
  html: https://shopify.dev/changelog/filter-orders-by-return-status
  md: https://shopify.dev/changelog/filter-orders-by-return-status.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

April 1, 2023

Tags:

* API
* 2023-04

# 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).