diff --git a/packages/catalog-client/src/types/api.ts b/packages/catalog-client/src/types/api.ts
index afd26076c9..13a7822df9 100644
--- a/packages/catalog-client/src/types/api.ts
+++ b/packages/catalog-client/src/types/api.ts
@@ -297,6 +297,16 @@ export interface GetEntityFacetsRequest {
    * of that key, no matter what its value is.
    */
   filter?: EntityFilterQuery;
+  /**
+   * If given, return only entities that match the given predicate query.
+   *
+   * @remarks
+   *
+   * Supports operators like `$all`, `$any`, `$not`, `$exists`, `$in`,
+   * `$contains`, and `$hasPrefix`. When both `filter` and `query` are
+   * provided, they are combined with `$all`.
+   */
+  query?: FilterPredicate;
   /**
    * Dot separated paths for the facets to extract from each entity.
    *