Inventory Items

The InventoryItem Object

The InventoryItem object represents a stock-managed promotional item that can be associated with prizes. It tracks available/on-hand quantities (including current values), commercial metadata (SKU, value per unit), active date range, and campaign/category context. It’s the object to use when you need a reliable view of promo stock availability and movement context.

Value	Type	Description
uuid	string	Inventory item UUID.
description	string	Description.
qty_available	integer	Available quantity.
qty_on_hand	integer	On-hand quantity.
current_qty_available	integer	Current available quantity.
current_qty_on_hand	integer	Current on-hand quantity.
vpu	number	Value-per-unit.
sku	string	SKU.
ad_hoc_enabled	boolean	Ad-hoc enabled flag.
start_date	string	Start date/time.
end_date	string	End date/time.
listener_notes	string	Listener notes.
campaign	object	Serialized Campaign object via CampaignBlueprint when present.
station_uuid	string	Station UUID when station_id is present.
category	object	Inline object with uuid, name when category exists.
archived_at	string	Archive timestamp.
created_at	string	Record creation timestamp.
updated_at	string	Record update timestamp.