Pricing

Understanding the different price types available through the API is essential for accurate pricing and order management.

Overview

The API provides multiple price types to support both wholesale and retail pricing scenarios. Retail prices are used to sell to consumers, while wholesale prices are used to sell to dealers. The lowest wholesale price returned for an item will be the price charged to the dealer.

Price types

The following price types are available:

Wholesale prices

Wholesale prices (types 0, 1, 2, 5) are the prices charged to dealers when purchasing inventory. These prices are:

• Base (0): The standard wholesale cost
• Sale (1): Promotional wholesale pricing
• Closeout (2): Reduced pricing for discontinued or clearance items
• Program (5): Special pricing for dealers enrolled in specific programs

When multiple wholesale prices are available, the API returns the lowest applicable price.

Retail prices

Retail prices (types 3, 4) are suggested prices for selling to end consumers:

• MAP (3): Minimum Advertised Price - the lowest price at which a product can be advertised
• MSRP (4): Manufacturer's Suggested Retail Price - the recommended retail price

These prices provide guidance for consumer-facing pricing but do not affect dealer purchase costs.

Using price types

When calling the /Catalog/Products/Prices endpoint, you can filter by specific price types:

const baseUrl = 'https://api.hlc.bike/us/v4.1'
const apiKey = process.env.HLC_API_KEY

// Get wholesale prices only (Base, Sale, Closeout, Program)
const res = await fetch(
  `${baseUrl}/Catalog/Products/Prices?sku=020056-07&prices=0,1,2,5`,
  { headers: { Authorization: apiKey, language: 'en' } },
)

const wholesalePrices = await res.json()