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

> ## Agent Instructions
> Authenticate every request with your API key in the `X-API-Key` header or `Authorization: Bearer`. Keys start with `sk-nunchux-`.
> Image generation is synchronous: the image is in the response.
> Video generation is asynchronous: submit the job, poll its task until it reaches a terminal status, then download the output promptly, because output URLs expire.

# Redeem a promo code

> Add free credits to a team's balance with a promo code.

# Redeem a promo code

### Add free credits to a team's balance with a promo code.

A promo code adds free credits to the balance of one team. You redeem it in the dashboard. There is no API endpoint for it.

## Who can redeem a code

The credits go to the team that is active in the dashboard when you redeem the code. You must be an admin of that team.

You are always the admin of your own team, listed as "Your team" in the account switcher. On a team where you are a member, ask one of its admins to redeem the code. Members have no Billing & Invoices page. See [Teams](https://docs.nunchux.ai/teams.md) for what each role can do.

## Redeem a code

**1. Pick the team**

In the dashboard sidebar, open the account switcher under the logo and select the team that should get the credits.

**2. Open Add Credits**

Go to [Billing & Invoices](https://nunchux.ai/dashboard/admin/billing) and select Top Up on the Credits card. The Add Credits window opens.

**3. Enter the code**

Type the code under "Have a promo code?" and select Redeem. The line under the field names the team that gets the credits. Letter case does not matter.

When the code works, the field clears and shows how many credits were added and the team's new balance.

## Where the credits show up

* The team's balance on the Credits card and in the dashboard's top bar.
* A row in the Invoices table on Billing & Invoices, with the description "Promo code credit".
* `credits_remaining` from [`GET /v1/credits`](https://docs.nunchux.ai/credits-pricing#checking-your-balance), for every API key billed to the team.

Promo credits join the team's balance, and they are spent like credits you paid for. The code itself has an expiry date, after which no one can redeem it. Redeeming a code does not change the team's plan.

## Limits

* A team can redeem each code once. If two admins of one team redeem the same code, only the first redemption adds credits.
* You can redeem each code once, for one team. You cannot redeem the same code into your own team and into another team.
* Different codes add up. A team can redeem several codes.
* Each code has its own number of redemptions. Once they are used up, the code stops working.
* Tries are limited per person, wrong codes included. After too many, the Redeem button stays disabled for up to a minute.

## Errors

When a code does not work, nothing is added, and the code stays in the field so you can fix a typo. The field shows one of these messages.

| Message | Meaning |
| - | - |
| We couldn't find that code. Check it for typos. | No code matches what you typed. |
| This code has expired. | The code is past its expiry date. |
| This code is no longer available. | The code's redemptions are used up, or the code was switched off. |
| \[Team] has already redeemed this code. Each organization can use a code once. | Someone already redeemed this code into the active team. |
| You've already redeemed this code for another organization. Each person can use a code once. | You redeemed this code into a different team. |
| Too many tries. Try again in \[N] seconds. | You hit the limit on tries. Wait, then try again. |
| Only org admins can add credits or change the card. | You are a member of the active team, not an admin. Ask an admin to redeem the code. |
| You switched accounts in another tab. Reload this page and try again. | The active team changed after the page loaded. Reload it, and check which team the field names before you redeem. |
| We couldn't redeem the code right now. Please try again. | A temporary problem on our side. Nothing was added. Try again. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.