Price Lists

Each site will be assigned a price list that determines ex tax unit prices of each item on sale.

Price lists work by overriding prices in their parent lists (just like subclassing in object-oriented programming). The base price list has a parent_id of null.

Get all price lists

GET /v1/companies/5678/price_lists Get all price lists

Get a price list

GET /v1/companies/5678/price_lists/base Get the base price list
GET /v1/companies/5678/price_lists/236 Get a price list by ID
  • The unit_price returned is always the ex tax price for that product.

Only products explicitly priced in the requested price list will be included. To get all products, including those inherited from parent lists, use the products sub-endpoint:

GET /v1/companies/5678/price_lists/236/products Get products for a price list, including all inherited products
  • The unit_price returned is always the ex tax price for that product.