Skip to main content

products

Search and retrieve products with comprehensive filtering, sorting, and aggregation capabilities.

Provides powerful product discovery functionality including text search, category filtering, attribute-based filtering, price ranges, and availability checks. Results include aggregated data for faceted search interfaces and support pagination for large product catalogs.

Possible errors:

  • PRODUCT_FETCH_ERROR: Failed to search products
  • ELASTICSEARCH_NO_RESULT: Search service unavailable
  • EMPTY_QUERY: Invalid search parameters

AUTH: Role=[product.OWNER,product.EDITOR,product.VIEWER] OR (('user is authenticated') AND ('userId if present in input matches JWT' AND 'companyId(s) if present in input matches JWT'))

products(
  input: ProductSearchInput
): ProductsResponse!

Arguments​

products.input ● ProductSearchInput input​

Product search criteria and filtering options.

If not provided, returns all accessible products with default pagination. Supports text search, category filtering, attribute filters, price ranges, and sorting options.

Type​

ProductsResponse object​

Paginated response containing product search results with filtering and aggregation data.

Provides a comprehensive response for product queries including matching items, pagination metadata, price ranges, and available filters for building rich product discovery interfaces.