GET /v1/shop/items returns your company’s reward catalogue as your employees see it in TeamBuilder. It needs the shop:read scope.
Response
What the catalogue contains
Only items enabled for your company are returned. Items your admins have switched off never appear, so you can render the response as is.category is one of gift_card, merch, perk, donation or experience; pass it as a query parameter to show one category.
Prices
coin_price is the effective price for your employees: the price your admins set for your company when they set one, otherwise TeamBuilder’s default price for the item. Prices are in coins only; the API exposes no money amounts.
To show whether someone can afford an item, compare coin_price with their coins from employee stats.
Stock
Stock falls as employees redeem, so treat it as a snapshot. A cache of a few minutes is fine for display; the final check happens when an employee redeems in TeamBuilder.
