List vouchers, coupons, gift cards and loyalty cards.

Use search for substring matching over name, issuer and redeem_code. Use item_type to filter: voucher | giftcard | coupon | loyaltycard. By default used and expired items are hidden; enable them with include_used / include_expired. Each item includes days_left (negative means expired).

Get full details of a single item by its id (UUID string).

Create a new item (coupon, voucher, gift card or loyalty card).

issuer should be the merchant DOMAIN like "amazon.es" — the checkout userscript matches on it. redeem_code is the coupon/voucher code. Dates use YYYY-MM-DD format; pass expiry_date as "" for no real expiry (upstream then sets it 50 years out). value_type is one of money | percentage | multiplier (percentage 0-100, multiplier >= 1). item_type is one of voucher | giftcard | coupon | loyaltycard (loyalty cards require value 0). Returns the created item.

Update fields of an existing item by id. Only provided fields change.

Editable: name, issuer, redeem_code, expiry_date (YYYY-MM-DD), description, currency, value, value_type (money | percentage | multiplier). Returns the updated item.

Toggle the used status of an item.

Calling this once marks the item as USED; calling it again marks it available again. The returned item reflects the new state.

Permanently delete an item by its id. This cannot be undone.