Pricing

Use the Products API to get pricing for a product.

Methods


					Host: api.digitalriver.com
Accept: application/json
Authorization: bearer your_access_token
User-Agent: Apache-HttpClient/4.5.2 (Java/1.8.0_102)
			
					The request body should be empty.
			
					HTTP/1.1 200 OK
			
					{"pricing": {
   "uri": "https://dispatch.digitalriver.com/v1/shoppers/me/products/product_ID/pricing",
   "listPrice":    {
      "currency": "USD",
      "value": 19.99
   },
   "listPriceWithQuantity":    {
      "currency": "USD",
      "value": 19.99
   },
   "salePriceWithQuantity":    {
      "currency": "USD",
      "value": 18.99
   },
   "formattedListPrice": "$19.99",
   "formattedListPriceWithQuantity": "$19.99",
   "formattedSalePriceWithQuantity": "$18.99",
   "totalDiscountWithQuantity":    {
      "currency": "USD",
      "value": 1
   },
   "formattedTotalDiscountWithQuantity": "$1.00",
   "discountDescription": "$1.00",
   "tax": {"vatPercentage": 0},
   "feePricing":    {
      "salePriceWithFeesAndQuantity":       {
         "currency": "USD",
         "value": 18.99
      },
      "formattedSalePriceWithFeesAndQuantity": "$18.99"
   },
   "listPriceIncludesTax": "false",
   "msrpPrice": null,
   "formattedMsrpPrice": null
}}
			

Response Body Parameters

Field
Data Type
Visibility
Description
pricing
link default The pricing for the product. For more information, see the Pricing API.
discountDescription
string
default
A description of the discount.
feePricing
structured default Provides any associated fee pricing, such as regulatory fees, for a product.
feePricing.salePriceWithFeesAndQuantity decimal default The sale price with fees and quantity.
feePricing.formattedSalePriceWithFeesAndQuantity decimal default The SalePriceWithFeesAndQuantity in locale currency format (for example, $18,99).
formattedDiscountWithQuantity decimal default The DiscountWithQuantity in locale currency format.
formattedIncentive
string
default
The incentive in locale currency format (for example, $9.99).  
formattedListPrice
string
expand
The listPrice in locale currency format (for example, $9.99).
formattedListPriceWithQuantity
string
expand
The listPriceWithQuantity in locale currency format (for example, $19.99).
formattedMsrpPrice
string
expand
The MSRP price in the locale currency format.
formatedSalePrice string default The salePrice in locale currency format (for example, $18.99).
formattedSalePriceWithFeesAndQuantity string default The sales price with fees and quantity in locale currency format (for example, 18.99).
formattedSalePriceWithQuantity
string
expand
The salePriceWithQuantity in locale currency format. (for example, $17.99).
formattedShipping
string
default
The shipping in locale currency format (for example, $9.99)
formattedSubtotal
string
default
The subtotal in locale currency format (for example, $9.99).
formattedSubtotalWithDiscount string default The subtotal with discount in locale currency format.
formattedTax
string
default
The tax in locale currency format (for example, $9.99).
formattedTotalDiscountWithQuantity
string
default
The totalDiscountWithQuantity in locale currency format (for example, $20.99).
incentive
decimal
default
An incentive is a discount amount that applied to the entire order but is not specific to any particular item. For example, if the customer has a discount for $10 off an order over $100, the incentive amount would be $10.  
listPrice
decimal
expand
The computed price of the product factoring in quantity, which includes the product amount and inclusive product fees, tax on inclusive fees. The extended list amount excludes the product tax, any applicable product discounts, shipping costs, as well as any exclusive product fees.
listPriceWithQuantity
decimal
expand
The computed price of the product factoring in the quantity which includes the product amount and inclusive product fees, and the tax on inclusive fees. The extended list amount excludes the product tax, any applicable product discounts, shipping costs, as well as any exclusive product fees.  
listPriceIncludesTax
Boolean
default
When true, the list price includes tax.
msrpPrice
decimal
epxand
Manufacturer's Suggest Retail Price (MSRP). The MRSP price might or might not match the list price.
salePriceWithQuantity
decimal
expand
The computed price of the product which includes the product amount, the product tax, inclusive product fees, and any applicable product discounts. The extended sales amount excludes tax, shipping costs, as well as any exclusive product fees.
shipping
decimal
default
The shipping cost for the order.
subtotal
decimal
default
The subtotal for the order.  
subtotalWithDiscount
string default The subtotal value with the applied discount. For example, if the subtotal is 17.99, and the discount 5.00, the subtotal minus the discount equals 12.99.
tax
decimal
default
The tax for the order.
tax.vatPercentage
decimal
default
The VAT percentage for the order.
total decimal default The total for the order.
totalDiscountWithQuantity decimal default The subtotal with discount.