> ## 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.

# redeem_code

> Redeem a promo code that adds money to the user's cash balance

Redeems a promo code that adds money to the user's cash balance. Each code works once per user; the credit lands in the balance and becomes spendable within a minute or two. See what the user has already redeemed or can retry with [list\_codes](/companies/mcp/tools/list_codes).

## Parameters

| Parameter | Type   | Required | Description                                                                   |
| --------- | ------ | -------- | ----------------------------------------------------------------------------- |
| `code`    | string | Yes      | The promo code exactly as the user provided it (case and dashes are forgiven) |

## Returns

On success, a confirmation with the credited amount; check [get\_balance](/companies/mcp/tools/get_balance) to watch it land. Failure cases tell you what happened: `invalid_code` (check for typos and retry), `expired`, `exhausted` (the code hit its redemption limit), `already_redeemed` (each code works once per user), or `in_progress` (a redemption from a moment ago is still processing; don't retry, the credit is on the way).

## Example

```json theme={null}
{ "name": "redeem_code", "arguments": { "code": "WELCOME-15" } }
```