# Promo codes

> Redeem a promo code for credit, and what each redemption error means.

Source: https://nodus-platform-site.pages.dev/docs/guides/billing/promo-codes/
Build revision: 211ad9f836655b1c3a2668c4693e442471f28614

A promo code adds a [credit grant](https://nodus-platform-site.pages.dev/docs/guides/billing/credits/) to your org. Redeem it from the CLI or from **Usage & billing → Credits → Redeem code** in the console:

Terminal window

```console
$ nodus billing redeem LAUNCH25
Redeemed ****CH25: $25.00 of credit, expires 2026-11-30.
```

Codes are not case-sensitive, and spaces around them are ignored. Redeeming needs the `billing:write` permission. The response shows the code masked to its last four characters; Nodus stores only a keyed digest of each code.

## Errors

|Error|Meaning|
|-|-|
|`404 NotFound`|The code does not exist, or it has been withdrawn|
|`410 Expired`|The code’s last redemption date has passed|
|`409 Conflict`|Your org has already redeemed this code, or the code has been fully redeemed|
|`429 TooManyRequests`|More than 5 attempts in a minute; wait a minute and try again|

Retrying a redemption with the same `Idempotency-Key` returns the first result and never adds credit twice. The CLI and console set the key for you.

## Expiry

A promo grant expires on the date the code sets, counted from when you redeem it. Codes without one never expire.