Skip to main content

productPrices

Retrieves pricing information for a specific product with advanced filtering capabilities.

Authentication & Permissions​

Requires authentication and products:read_prices permission for the product's brand.

Pricing Context​

Prices can be associated with different entities (customers or sales channels) and have varying unit limits. When maxUnits is null, the price applies to unlimited quantities.

Filtering Behavior​

  • **Priceable filters**: Both priceableType and priceableId must be provided together or omitted together
  • **Unit range with minimum only**: Includes unlimited prices (maxUnits is null) along with prices meeting the minimum threshold
  • **Date ranges**: Inclusive of both start and end dates

Ordering​

Results are ordered by maxUnits in ascending order, with unlimited prices (null values) appearing last.

Possible Errors​

  • **Product not found**: Invalid or non-existent product ID
  • **Access denied**: Insufficient permissions for the product's brand
  • **Invalid priceable filter**: Only one of priceableType or priceableId provided
productPrices(
  filters: ProductPriceFilterInput
  productId: ID!
): [ProductPrice!]!

Arguments​

productPrices.filters ● ProductPriceFilterInput input products​

productPrices.productId ● ID! non-null scalar common​

Type​

ProductPrice object products​