Fetch Customer Products

1 min

GET

https://api.nue.io/customers/{customerId}/products

Returns the published product catalog filtered to only the price book entries relevant to a specific customer based on their account-level pricing attributes.

This endpoint fetches the customer record and the full catalog in parallel, then evaluates each price book entry's pricing attribute mappings against the customer's account fields. Products with zero matching price book entries are excluded. Bundle product options are filtered by the same rules.

Filtering rules:

PBEs with no pricing attributes are universal (always included)
Only Account-level mappings (Quote.AccountId.*) are evaluated
__ANY__ wildcard values always match
All account-level conditions must match for a PBE to be included
Quote-level mappings are ignored (evaluated at order time)

The response shape is identical to GET /catalog/products.

customerIdstringThe customer ID (Nue ID or Salesforce external ID).

productIdsstringRestricts the response to the named products, given as a JSON array of product IDs (for example <code>["01tQC00000Iu1ofYAB","01tQC00000KBr8jYAD"]</code>). When supplied, each product is fetched individually rather than reading the entire published catalog, which keeps large catalogs within the upstream response size limit. Omit the parameter to return the whole catalog as before. Notes: <ul> <li>Values are product IDs, not SKUs. Double quotes are required; an empty array, a value that is not valid JSON, or a non-string element returns 400 INVALID_PARAMETER.</li> <li>Repeated IDs are de-duplicated to a single lookup.</li> <li>An ID that cannot be resolved, or a product with no price book entry matching the customer, does not fail the request. Those IDs are reported in a PRODUCTS_NOT_FOUND warning and omitted from <code>data</code>.</li> <li>Customer pricing-attribute filtering is applied exactly as it is without this parameter.</li> </ul>

acceptstringGenerated from available response content types

200Customer-filtered product catalog returned successfully.

401Unauthorized

404Customer not found

curl --request GET \
     --url https://api.nue.io/customers/{customerId}/products \
     --header 'accept: application/json'