The Products List (POST) API is the correct choice for retrieving a list of products belonging to a specific catalog during the browse phase of guided selling in Revenue Cloud. This API endpoint is specifically designed as a composite API for Product Discovery and provides comprehensive filtering capabilities.
According to the Revenue Cloud Developer Guide, the Products List (POST) resource is located at /connect/cpq/products and accepts POST requests with a JSON body. This API allows consultants to specify multiple parameters including catalogId, categoryId, priceBookId, productClassificationId, and various filtering criteria. The POST method is preferred over GET because it can handle complex request bodies with multiple filter criteria, user context information, and qualification/pricing procedures.
The API supports essential Product Discovery features such as enableQualification and enablePricing flags, which are critical during the browse phase. It can also include contextDefinition and contextMapping parameters to ensure proper data flow during guided selling. The Products List (POST) returns a paginated list of products with complete details including pricing information, qualification status, and catalog associations.
Option A (Products List GET) does not exist as a standard Product Catalog Management business API. Option B (Product Related Records List POST) is used for retrieving related records like ProductRampSegment or ProductUsageGrant, not for product lists. The Products List (POST) API is explicitly documented in the Product Discovery Business APIs section of the Revenue Cloud Developer Guide for browsing and discovering products during the sales transaction process.
[References: Revenue Cloud Developer Guide - Product Discovery Business APIs, Product Catalog Management Business APIs section, , ]
