used (credit already sent), processing (mid-transfer), available (a failed attempt they can retry with redeem_code), or expired. Codes the user has never presented cannot be listed; they only enter the history via redeem_code.
Advanced tool. Not advertised in the default
tools/list (it is the read companion of redeem_code); it remains callable by name. See tool gating.Parameters
This tool takes no parameters.Returns
The user’s promo-code history newest first, each entry with thecode (canonical uppercase form), its amount_cents of balance credit, and its state, plus a count. With no history, you get a “no codes” note.