---
title: >-
  New filter options added to orders connection in Customer Account API -
  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/posts/new-filter-options-added-to-orders-connection-in-customer-account-api
  md: >-
    https://shopify.dev/changelog/posts/new-filter-options-added-to-orders-connection-in-customer-account-api.md
metadata:
  effectiveApiVersion: 2025-07
  affectedApi:
    - displayName: Customer Account API
      handle: customer-account-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2025-04-30T14:49:50-04:00'
  postedAt: '2025-05-02T12:00:00-04:00'
  updatedAt: '2025-07-30T09:59:37-04:00'
  effectiveAt: '2025-05-01T12:00:00-04:00'
---

May 2, 2025

# New filter options added to `orders` connection in Customer Account API

DateMay 2, 2025

Version[2025-07](https://shopify.dev/changelog?api_version=2025-07)

FlagsUpdate

SurfacesAPI

Affected APIs[Customer Account API](https://shopify.dev/changelog?api_type=customer-account-graphql)

We have added new query parameters to the `orders` connection ([`OrderConnection`](https://shopify.dev/docs/api/customer/latest/connections/OrderConnection)) within the [`customer`](https://shopify.dev/docs/api/customer/latest/queries/customer) [`query`](https://shopify.dev/docs/api/customer/latest/queries/customer#returns-Customer.fields.orders.arguments.query) of the GraphQL Customer Account API.

Developers can now filter orders using the [`name`](https://shopify.dev/docs/api/customer/latest/queries/customer#argument-query-filter-name) and [`confirmation_number`](https://shopify.dev/docs/api/customer/latest/queries/customer#argument-query-filter-confirmation_number) parameters, which enables more precise order filtering.