Search for pricebook items across multiple pricebooks

This endpoint allows you to search for products/items across one or more supplier pricebooks using a text-based search query. The search is performed across item names, product codes, and search values.

Search Behavior:

• Searches match when the search term appears anywhere within searchable fields (substring matching)
• Results are ranked by relevance (exact matches and word-start matches ranked higher)
• Pagination uses cursor-based navigation with encoded ranking information

allSuppliers

When allSuppliers is provided and set to true, it will override the list of supplierIds array.

For example the below payload will search across all suppliers for the term "hammer" and apply the pricing tier with id 123:

{
  "search": "hammer",
  "pricingTierId": 123,
  "allSuppliers": true,
  "supplierIds": [
    101,
    102,
    103
  ]
}

To narrow search by specific suppliers, set allSuppliers to false and provide a list of supplier IDs:

{
  "search": "hammer",
  "pricingTierId": 123,
  "allSuppliers": false,
  "supplierIds": [
    101,
    102,
    103
  ]
}