Get product details (variants, options and images) by product ID(s).
Arguments:
productIds - array of product IDs to get details for (from 'search_products').
[IMPORTANT] Request only the products the user needs. A server-configured limit
applies (default 20); requests over the limit are rejected with an error (retry with fewer IDs).
option_values - resolve a specific variant by option/value IDs. Only valid with a SINGLE
productId, and applied on the B2C storefront catalog. B2B buyers instead receive every
variant (each with its option/value IDs) and pick the desired one from the returned list.
channelId - optional; scopes the B2B catalog. Defaults to the channel resolved from the request.
Returns:
- products: array of products, each with:
- variants: each carrying entityId, SKU, and options (optionId, optionLabel, valueId, valueLabel).
- For B2B buyers, variants also include price, inventoryLevel, purchaseable, and bulkPricing.
- Products not found are omitted from the array.
Flow:
- Call 'search_products' to get product IDs.
- Call this tool with the product IDs to get variants, options and images.
- Call 'add_item_to_cart' with results of 'search_products' and 'get_product_details' (variant) tools.
- [IMPORTANT] If a product has variants you must specify which variant to add.