---
title: >-
  Re-enabled customer search terms in the GraphQL and REST Admin APIs - 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/re-enabled-customer-search-terms'
  md: 'https://shopify.dev/changelog/re-enabled-customer-search-terms.md'
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Admin REST API
      handle: admin-rest
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2025-03-25T17:17:26-04:00'
  postedAt: '2025-03-26T12:00:00-04:00'
  updatedAt: '2025-03-26T09:24:21-04:00'
  effectiveAt: '2025-03-26T12:00:00-04:00'
---

March 26, 2025

Tags:

* Admin GraphQL API
* Admin REST API

# Re-enabled customer search terms in the GraphQL and REST Admin APIs

We've re-enabled several customer-related `query` terms in all versions of the [GraphQL Admin API](https://shopify.dev/docs/api/admin-graphql/2024-07/queries/customers#argument-query) and [REST Admin API](https://shopify.dev/docs/api/admin-rest/2024-07/resources/customer#get-customers-search?query=email:bob.norman@mail.example.com).

Version 2024-07 of these APIs disabled the following `query` terms for searching customers:

* `accepts_marketing`
* `city`
* `company`
* `country`
* `customer_date`
* `email_marketing_state`
* `last_abandoned_order_date`
* `order_date`
* `orders_count`
* `province`
* `sms_marketing_state`
* `state`
* `tag`
* `tag_not`
* `territory_code`
* `total_spent`

These options have been re-enabled across all API versions, allowing for more specific customer searches. For more details, refer to the [GraphQL Admin API documentation](https://shopify.dev/docs/api/admin-graphql/2024-07/queries/customers#argument-query) and the [REST Admin API documentation](https://shopify.dev/docs/api/admin-rest/2024-07/resources/customer#get-customers-search?query=email:bob.norman@mail.example.com).
