> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# list_codes

> List the user's promo codes and their redemption state

Lists the user's promo (coupon) codes: every code they have redeemed or attempted, with its amount and state: `used` (credit already sent), `processing` (mid-transfer), `available` (a failed attempt they can retry with [redeem\_code](/companies/mcp/tools/redeem_code)), or `expired`. Codes the user has never presented cannot be listed; they only enter the history via `redeem_code`.

<Note>
  **Advanced tool.** Not advertised in the default `tools/list` (it is the read companion of [redeem\_code](/companies/mcp/tools/redeem_code)); it remains callable by name. See [tool gating](/companies/mcp/overview#tool-gating).
</Note>

## Parameters

This tool takes no parameters.

## Returns

The user's promo-code history newest first, each entry with the `code` (canonical uppercase form), its `amount_cents` of balance credit, and its state, plus a `count`. With no history, you get a "no codes" note.

## Example

```json theme={null}
{ "name": "list_codes", "arguments": {} }
```