---
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'
metadata:
  effectiveApiVersion: 2023-04
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2023-02-24T08:35:54-05:00'
  postedAt: '2023-04-01T00:00:00-04:00'
  updatedAt: '2024-12-13T17:24:36-05:00'
  effectiveAt: '2023-04-01T00:00:00-04:00'
---

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