Skip to main content
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.

Redemption happens in TeamBuilder

The API is read-only for the shop. Employees redeem in their TeamBuilder portal, where approvals, fulfilment and coin holds are handled. Link each item to the portal rather than building a checkout of your own.
is_new is a highlight your admins set on an item; use it to badge the item as new. Cache the catalogue on your server: it changes only when admins edit it or stock moves.