A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about Shopify API search syntax.

Anchor to default •string: Filter by a case-insensitive search of multiple fields in a document.
Anchor to accepts_marketing •boolean: Filter by whether a customer has consented to receive marketing material.
Anchor to country •string: Filter by the country associated with the customer's address. Use either the country name or the two-letter country code.
Anchor to customer_date •time: Filter by the date and time when the customer record was created. This query parameter filters by the createdAt field.
Anchor to email •string: The customer's email address, used to communicate information about orders and for the purposes of email marketing campaigns. You can use a wildcard value to filter the query by customers who have an email address specified. Please note that email is a tokenized field: To retrieve exact matches, quote the email address (phrase query) as described in Shopify API search syntax.
Anchor to first_name •string: Filter by the customer's first name.
Anchor to id •id: Filter by id range.
Anchor to last_abandoned_order_date •time: Filter by the date and time of the customer's most recent abandoned checkout. An abandoned checkout occurs when a customer adds items to their cart, begins the checkout process, but leaves the site without completing their purchase.
Anchor to last_name •string: Filter by the customer's last name.
Anchor to order_date •time: Filter by the date and time that the order was placed by the customer. Use this query filter to check if a customer has placed at least one order within a specified date range.
Anchor to orders_count •integer: Filter by the total number of orders a customer has placed.
Anchor to phone •string: The phone number of the customer, used to communicate information about orders and for the purposes of SMS marketing campaigns. You can use a wildcard value to filter the query by customers who have a phone number specified.
Anchor to state •string: Filter by the state of the customer's account with the shop. This filter is only valid when Classic Customer Accounts is active.
Anchor to tag •string: Filter by the tags that are associated with the customer. This query parameter accepts multiple tags separated by commas.
Anchor to tag_not •string: Filter by the tags that aren't associated with the customer. This query parameter accepts multiple tags separated by commas.
Anchor to •- `tag_not:'Prospect'`<br/> - `tag_not:'Test,Internal'`
Anchor to total_spent •float: Filter by the total amount of money a customer has spent across all orders.
Anchor to updated_at •time: The date and time, matching a whole day, when the customer's information was last updated.