For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dev Portal
DocsAPI ReferenceLearnCommunityChangelog
DocsAPI ReferenceLearnCommunityChangelog
    • About Our APIs
  • REST
    • Overview
  • GraphQL
    • Overview
      • Playground
          • QUERYcompanyRoles
          • QUERYcompanyRole
          • QUERYcompanyPermissions
          • QUERYaccountSettings
          • QUERYcustomerAccountSettings
          • QUERYinvoices
          • QUERYinvoice
          • QUERYinvoiceStats
          • QUERYinvoiceCustomerInformation
          • QUERYinvoicePaymentModules
          • QUERYinvoiceBcOrderAllowMethods
          • QUERYinvoicePaymentBcCart
          • QUERYinvoicePaymentFees
          • QUERYreceipts
          • QUERYreceipt
          • QUERYallReceiptLines
          • QUERYreceiptLine
          • QUERYreceiptLines
          • QUERYorder
          • QUERYallOrders
          • QUERYorderProducts
          • QUERYorderedProducts
          • QUERYcustomerOrders
          • QUERYcustomerOrder
          • QUERYcreatedByUser
          • QUERYshoppingLists
          • QUERYshoppingList
          • QUERYshoppingListsIdName
          • QUERYcustomerShoppingLists
          • QUERYcustomerShoppingList
          • QUERYcustomerShoppingListsIdName
          • QUERYcompanyExtraFields
          • QUERYuserCompany
          • QUERYcompanyValidateEmail
          • QUERYcompanyUserInfo
          • QUERYaccountFormFields
          • QUERYcompanyCreditConfig
          • QUERYcompanyPaymentTerms
          • QUERYcompanySubsidiaries
          • QUERYsuperAdminCompanies
          • QUERYsuperAdminMasquerading
          • QUERYquotes
          • QUERYcustomerQuotes
          • QUERYquote
          • QUERYquoteUserStoreInfo
          • QUERYquoteConfig
          • QUERYquoteExtraFieldsConfig
          • QUERYusers
          • QUERYuser
          • QUERYuserEmailCheck
          • QUERYcustomerEmailCheck
          • QUERYuserExtraFields
          • QUERYcurrentUser
          • QUERYcustomerInfo
          • QUERYuserLoginState
          • QUERYuserMasqueradingCompany
          • QUERYorderStatuses
          • QUERYbcOrderStatuses
          • QUERYcurrencies
          • QUERYautoLoader
          • QUERYstoreLimitations
          • QUERYstoreBasicInfo
          • QUERYstorefrontScript
          • QUERYstorefrontDefaultLanguage
          • QUERYstorefrontProductSettings
          • QUERYstorefrontSettings
          • QUERYstoreConfigSwitchStatus
          • QUERYstoreCheckoutConfig
          • QUERYstorefrontConfig
          • QUERYstorefrontConfigs
          • QUERYproductVariantsInfo
          • QUERYvariantSku
          • QUERYproductsInventory
          • QUERYproductsLoad
          • QUERYproductsSearch
          • QUERYtaxZoneRates
          • QUERYproductPurchasable
          • QUERYvalidateProduct
          • QUERYvalidateProducts
          • QUERYpriceProducts
          • QUERYaddresses
          • QUERYaddress
          • QUERYcountries
          • QUERYdefaultShippingAddress
          • QUERYdefaultBillingAddress
          • QUERYcustomerAddresses
          • QUERYcustomerAddress
          • QUERYaddressConfig
          • QUERYaddressExtraFields
  • MCP
    • Overview
Dev Portal
LogoLogo
GraphQLB2BQueries

priceProducts

Example Query
1query ExampleQuery($storeHash: String, $channelId: Int, $currencyCode: String, $customerGroupId: Int, $items: [PricingProductItemInputType]) {
2 priceProducts(storeHash: $storeHash, channelId: $channelId, currencyCode: $currencyCode, customerGroupId: $customerGroupId, items: $items) {
3 productId
4 variantId
5 options {
6 optionId
7 valueId
8 }
9 referenceRequest {
10 productId
11 variantId
12 options
13 }
14 retailPrice {
15 asEntered
16 enteredInclusive
17 taxExclusive
18 taxInclusive
19 }
20 salePrice {
21 asEntered
22 enteredInclusive
23 taxExclusive
24 taxInclusive
25 }
26 minimumAdvertisedPrice {
27 asEntered
28 enteredInclusive
29 taxExclusive
30 taxInclusive
31 }
32 saved {
33 asEntered
34 enteredInclusive
35 taxExclusive
36 taxInclusive
37 }
38 price {
39 asEntered
40 enteredInclusive
41 taxExclusive
42 taxInclusive
43 }
44 calculatedPrice {
45 asEntered
46 enteredInclusive
47 taxExclusive
48 taxInclusive
49 }
50 }
51}
Variables
1{
2 "storeHash": "example",
3 "channelId": 0,
4 "currencyCode": "example",
5 "customerGroupId": 0,
6 "items": [
7 {
8 "productId": 0,
9 "variantId": 0,
10 "options": [
11 {
12 "optionId": 0,
13 "valueId": 0
14 }
15 ]
16 }
17 ]
18}
Example response
1{
2 "data": {
3 "priceProducts": [
4 {
5 "productId": 0,
6 "variantId": 0,
7 "options": [
8 {
9 "optionId": 0,
10 "valueId": 0
11 }
12 ],
13 "referenceRequest": {
14 "productId": 0,
15 "variantId": 0,
16 "options": [
17 {
18 "optionId": null,
19 "valueId": null
20 }
21 ]
22 },
23 "retailPrice": {
24 "asEntered": 0,
25 "enteredInclusive": true,
26 "taxExclusive": 0,
27 "taxInclusive": 0
28 },
29 "salePrice": {
30 "asEntered": 0,
31 "enteredInclusive": true,
32 "taxExclusive": 0,
33 "taxInclusive": 0
34 },
35 "minimumAdvertisedPrice": {
36 "asEntered": 0,
37 "enteredInclusive": true,
38 "taxExclusive": 0,
39 "taxInclusive": 0
40 },
41 "saved": {
42 "asEntered": 0,
43 "enteredInclusive": true,
44 "taxExclusive": 0,
45 "taxInclusive": 0
46 },
47 "price": {
48 "asEntered": 0,
49 "enteredInclusive": true,
50 "taxExclusive": 0,
51 "taxInclusive": 0
52 },
53 "calculatedPrice": {
54 "asEntered": 0,
55 "enteredInclusive": true,
56 "taxExclusive": 0,
57 "taxInclusive": 0
58 }
59 }
60 ]
61 }
62}
Calculate batch pricing for products for a specific channel, currency, and customer group.
Was this page helpful?
Previous

validateProducts

Next

addresses

Built with

Arguments

storeHashStringOptional
Store hash.
channelIdIntegerOptional
The channel ID that pricing evaluates within.
currencyCodeStringRequired
The currency code of prices this request returns. This field is required.
customerGroupIdIntegerOptional
The customer group ID that's relevant for any customer group pricing, tax values, etc.
itemslist of optional PricingProductItemInputTypeRequired
The items for which to fetch prices. This field is required.

Returns

an optional list of optional PricingProductType
productIdInteger
The product ID of the item.
variantIdInteger
The variant ID of the item.
optionslist of optional PricingProductItemOptionsType
The optional product option configuration for this generated price.
referenceRequestReferenceRequestType
You can use the original details of the request to identify the exact product variant and fetch prices.
retailPricePriceType

The (optional) RRP/retail price configured for this product and used for price comparison and storefront display purposes.

salePricePriceType

The merchant-entered sale price for a product overwrites the default price. The sale_price is optional.

minimumAdvertisedPricePriceType

The minimum advertised price (MAP) you can display on a storefront. A value supplied by the merchant and used for display purposes.

savedPriceType

The amount that merchants save, determined by the difference between retail_price and calculated_price

pricePriceType

The merchant-entered price for a product, which could include or exclude tax. When creating a product, you must define the price, which serves as the default price.

calculatedPricePriceType

The shopper price for a product, which includes modifier, option, and option set rules. The calculated_price may include or exclude estimates for tax.

priceRangePriceRangeType

The minimum and maximum price that will typically apply to this product. Only used for complex products (products with variants).

retailPriceRangePriceRangeType

The productʼs variants that will typically apply to this product.

bulkPricinglist of optional BulkPricingType
The bulk pricing rules that apply to this product.