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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Promo Codes API

> En Promo Code er en rabat, som en køber indtaster i checkout, enten en procentdel eller et fast beløb.

Den tilhører en konto, kan begrænses til ét produkt og styrer, hvem der kan indløse den, hvor mange gange, indtil hvornår, og i hvor mange faktureringsperioder rabatten varer.

Brug Promo Codes API'et til at oprette koder for en konto, vise og hente dem, deaktivere en kode for at sætte indløsninger på pause eller aktivere den igen og arkivere koder, du ikke længere tilbyder.

## Endpoints

| Endpoint | Anmodning |
| - | - |
| [Vis Promo Codes](https://docs.whop.com/da/api-reference/promo-codes/list-promo-codes.md) | GET `/promo_codes` |
| [Hent Promo Code](https://docs.whop.com/da/api-reference/promo-codes/retrieve-promo-code.md) | GET `/promo_codes/{id}` |
| [Opret Promo Code](https://docs.whop.com/da/api-reference/promo-codes/create-promo-code.md) | POST `/promo_codes` |
| [Aktivér Promo Code](https://docs.whop.com/da/api-reference/promo-codes/activate-promo-code.md) | POST `/promo_codes/{id}/activate` |
| [Deaktivér Promo Code](https://docs.whop.com/da/api-reference/promo-codes/deactivate-promo-code.md) | POST `/promo_codes/{id}/deactivate` |
| [Slet Promo Code](https://docs.whop.com/da/api-reference/promo-codes/delete-promo-code.md) | DELETE `/promo_codes/{id}` |

## Attributter

**id** `string` *required*

Promo code-id med præfikset `promo_`.

**account** `object` *required*

Den konto, der ejer rabatkoden.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Konto-id med præfikset `biz_`.
>
> **title** `string` *required*
>
> Kontoens visningsnavn.

**affiliate** `object | null` *required*

Den affiliate, der krediteres for henvisninger, som bruger rabatkoden, eller `null`, når ingen affiliate er tilknyttet.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Affiliate-id med præfikset `aff_`.
>
> **user** `object` *required*
>
> Den bruger, der er affiliaten.
>
> > [accordion] Egenskaber
> >
> > **id** `string` *required*
> >
> > Affiliatens bruger-id med præfikset `user_`.
> >
> > **name** `string | null` *required*
> >
> > Affiliatens visningsnavn.
> >
> > **profile\_pic** `string` *required*
> >
> > Affiliatens avatar-URL, inklusive den genererede reserve, når der ikke er angivet en avatar.
> >
> > **username** `string | null` *required*
> >
> > Affiliatens offentlige brugernavn.

**amount\_off** `number` *required*

Rabatbeløb. Procentrabatter angives som en decimalbrøk.

**churned\_users\_only** `boolean` *required*

Om rabatkoden er begrænset til tidligere kunder, der er faldet fra.

**code** `string | null` *required*

Koden, der indtastes i checkout.

**created\_at** `string` *required*

Hvornår rabatkoden blev oprettet, som et ISO 8601-tidsstempel.

**currency** `string` *required*

Den valuta, der bruges til en rabat med fast beløb.

Tilgængelige muligheder: `usd`, `sgd`, `inr`, `aud`, `brl`, `cad`, `dkk`, `eur`, `nok`, `gbp`, `sek`, `chf`, `hkd`, `huf`, `jpy`, `mxn`, `myr`, `pln`, `czk`, `nzd`, `aed`, `eth`, `ape`, `cop`, `ron`, `thb`, `bgn`, `idr`, `dop`, `php`, `try`, `krw`, `twd`, `vnd`, `pkr`, `clp`, `uyu`, `ars`, `zar`, `dzd`, `tnd`, `mad`, `kes`, `kwd`, `jod`, `all`, `xcd`, `amd`, `bsd`, `bhd`, `bob`, `bam`, `khr`, `crc`, `xof`, `egp`, `etb`, `gmd`, `ghs`, `gtq`, `gyd`, `ils`, `jmd`, `mop`, `mga`, `mur`, `mdl`, `mnt`, `nad`, `ngn`, `mkd`, `omr`, `pyg`, `pen`, `qar`, `rwf`, `sar`, `rsd`, `lkr`, `tzs`, `ttd`, `uzs`, `rub`, `btc`, `cny`, `usdt`, `kzt`, `awg`, `whop_usd`, `xau`, `hnl`

**duration** `string` *required*

Hvor længe rabatten gælder.

Tilgængelige muligheder: `forever`, `once`, `repeating`

**existing\_memberships\_only** `boolean` *required*

Om rabatkoden kun gælder for eksisterende medlemskaber.

**expires\_at** `string | null` *required*

Hvornår rabatkoden udløber, som et ISO 8601-tidsstempel.

**metadata** `object` *required*

Brugerdefinerede nøgle-værdi-metadata gemt på rabatkoden.

**new\_users\_only** `boolean` *required*

Om rabatkoden er begrænset til nye kunder.

**one\_per\_customer** `boolean` *required*

Om hver kunde kun må indløse rabatkoden én gang.

**product** `object | null` *required*

Det produkt, som rabatkoden er begrænset til, eller `null`, når den ikke er afgrænset til et produkt.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Produkt-id med præfikset `prod_`.
>
> **title** `string` *required*
>
> Produktets visningsnavn.

**promo\_duration\_months** `integer | null` *required*

De faktureringsintervaller, som rabatten gælder for.

**promo\_type** `string` *required*

Om rabatten er procentbaseret eller et fast beløb.

Tilgængelige muligheder: `percentage`, `flat_amount`

**status** `string` *required*

Rabatkodens livscyklusstatus.

Tilgængelige muligheder: `active`, `inactive`, `archived`

**stock** `integer` *required*

Maksimalt antal anvendelser, når beholdningen er begrænset.

**unlimited\_stock** `boolean` *required*

Om rabatkoden ikke har nogen indløsningsgrænse.

**updated\_at** `string` *required*

Hvornår rabatkoden blev opdateret, som et ISO 8601-tidsstempel.

**uses** `integer` *required*

Medlemskaber, der har brugt rabatkoden.

```json PromoCode theme={null}
{
	"id": "promo_xxxxxxxxxxxxxx",
	"code": "SUMMER25",
	"account": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Shine Time Auto Detailing"
	},
	"product": {
		"id": "prod_xxxxxxxxxxxxxx",
		"title": "Ceramic Coating Package"
	},
	"affiliate": {
		"id": "aff_xxxxxxxxxxxxxx",
		"user": {
			"id": "user_xxxxxxxxxxxxxx",
			"username": "danawhitfield",
			"name": "Dana Whitfield",
			"profile_pic": "https://ui-avatars.com/api/?name=Dana+Whitfield"
		}
	},
	"status": "active",
	"promo_type": "percentage",
	"amount_off": 0.25,
	"currency": "usd",
	"duration": "repeating",
	"promo_duration_months": 3,
	"new_users_only": true,
	"churned_users_only": false,
	"existing_memberships_only": false,
	"one_per_customer": true,
	"unlimited_stock": false,
	"stock": 200,
	"uses": 37,
	"expires_at": "2026-12-31T23:59:59.000Z",
	"metadata": {},
	"created_at": "2026-09-01T12:00:00.000Z",
	"updated_at": "2026-09-01T12:00:00.000Z"
}
```


## Related topics

- [Delete Promo Code](https://docs.whop.com/da/api-reference/promo-codes/delete-promo-code.md)
- [Delete promo code](https://docs.whop.com/da/api-reference/legacy/promo-codes/delete-promo-code.md)
- [Retrieve Promo Code](https://docs.whop.com/da/api-reference/promo-codes/retrieve-promo-code.md)
