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

# Memberships API

> Et Membership er en kundes køb af en variant: det abonnement eller den engangstildeling, der giver dem adgang til et produkt.

Det registrerer faktureringstilstand (`active`, `trialing`, `past_due` osv.), den aktuelle periode, afventende opsigelser, tilpassede metadata og softwarelicensnøglen, når produktet inkluderer licensering.

Brug Memberships API til at liste en kontos medlemskaber eller dine egne, hente et ud fra ID eller licensnøgle, invitere en modtager til at blive medlem via en gratis variant og administrere livscyklussen: opsige straks eller ved periodens udløb, tilbageføre en planlagt opsigelse, sætte betalingsopkrævning på pause og genoptage den, forlænge eller genaktivere adgang, anvende en rabatkode eller affiliate, ændre fornyelseskadence, synkronisere adgang igen, generere et overførselslink og opdatere metadata.

> [!NOTE]
>
> Erstatter Legacy-ressourcen [Memberships](https://docs.whop.com/da/api-reference/memberships/membership). Eksisterende Legacy-integrationer fortsætter med at fungere; se [API-versioner](https://docs.whop.com/da/developer/api/versioning.md) for stabilitetsaftalen.

## Endpoints

| Endpoint | Anmodning |
| - | - |
| [List Memberships](https://docs.whop.com/da/api-reference/memberships/list-memberships.md) | GET `/memberships` |
| [Retrieve Membership](https://docs.whop.com/da/api-reference/memberships/retrieve-membership.md) | GET `/memberships/{id}` |
| [Apply Promo Code to Membership](https://docs.whop.com/da/api-reference/memberships/apply-promo-code-to-membership.md) | POST `/memberships/{id}/apply_promo_code` |
| [Assign Affiliate to Membership](https://docs.whop.com/da/api-reference/memberships/assign-affiliate-to-membership.md) | POST `/memberships/{id}/assign_affiliate` |
| [Cancel Membership](https://docs.whop.com/da/api-reference/memberships/cancel-membership.md) | POST `/memberships/{id}/cancel` |
| [Extend Membership](https://docs.whop.com/da/api-reference/memberships/extend-membership.md) | POST `/memberships/{id}/extend` |
| [Pause Membership](https://docs.whop.com/da/api-reference/memberships/pause-membership.md) | POST `/memberships/{id}/pause` |
| [Reactivate Membership](https://docs.whop.com/da/api-reference/memberships/reactivate-membership.md) | POST `/memberships/{id}/reactivate` |
| [Resume Membership](https://docs.whop.com/da/api-reference/memberships/resume-membership.md) | POST `/memberships/{id}/resume` |
| [Resync Membership Access](https://docs.whop.com/da/api-reference/memberships/resync-membership-access.md) | POST `/memberships/{id}/resync_access` |
| [Transfer Membership](https://docs.whop.com/da/api-reference/memberships/transfer-membership.md) | POST `/memberships/{id}/transfer` |
| [Invite to a Membership](https://docs.whop.com/da/api-reference/memberships/invite-to-a-membership.md) | POST `/memberships/invite` |
| [Update Membership](https://docs.whop.com/da/api-reference/memberships/update-membership.md) | PATCH `/memberships/{id}` |

## Attributter

**id** `string` *required*

Medlemskabs-ID med præfikset `mem_`.

**account** `object` *required*

Kontoen (sælgeren), som dette medlemskab tilhører.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Konto-ID med præfikset `biz_`.
>
> **logo\_url** `string | null` *required*
>
> URL til kontoens logobillede. `null`, når kontoen ikke har angivet et.
>
> **route** `string` *required*
>
> Kontoens offentlige rute-identifikator, der bruges i butiksstien `whop.com/\{route}`.
>
> **title** `string` *required*
>
> Kontoens visningsnavn.

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

Medlemskabets affiliatekommission. `null` uden en affiliate, uden `affiliate:basic:read` på kontoen og altid i webhooks.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Affiliate-ID med præfikset `aff_`.
>
> **applies\_to\_payments** `string` *required*
>
> Om kommissionen kun udbetales på medlemskabets første betaling eller på alle dets betalinger.
>
> Tilgængelige muligheder: `first_payment`, `all_payments`
>
> **commission\_amount** `object | null` *required*
>
> Den faste kommission i medlemskabets valuta, eller `null` for en procentsats.
>
> > [accordion] Egenskaber
> >
> > **amount** `string` *required*
> >
> > Beløbet i hovedenheder som en eksakt decimalstreng. For eksempel er `"10.00"` ti dollars. Det er en streng, så ingen float afrunder det under overførslen.
> >
> > **currency** `string` *required*
> >
> > Trebogstavs ISO 4217-valutakode med små bogstaver.
> >
> > **decimals** `integer` *required*
> >
> > Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
> >
> > **display\_decimals** `integer` *required*
> >
> > Hvor mange decimaler der skal VISES. Normalt lig med `decimals`, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er `2` og `0`. Formatér tallet i din egen locale ved hjælp af dette.
>
> **commission\_percentage** `number | null` *required*
>
> Den procentvise kommission i procentpoint, så `20` betyder 20 %, eller `null` for et fast gebyr.
>
> **commission\_source** `string` *required*
>
> Hvordan kommissionssatsen blev fastsat: `custom` for en sats fastsat for denne affiliate, `member` for planens eller produktets medlemsaffiliatesats, `global` for produktets globale affiliatesats, eller `marketplace` for en henvisning fra Whop-marketplacet.
>
> Tilgængelige muligheder: `custom`, `member`, `marketplace`, `global`
>
> **commission\_type** `string` *required*
>
> Om kommissionen er en procentsats eller et fast gebyr.
>
> Tilgængelige muligheder: `flat_fee`, `percentage`
>
> **enabled** `boolean` *required*
>
> Om dette medlemskab udbetaler affiliatekommissioner. `false` betyder, at affiliaten bevares på medlemskabet, men ikke længere bliver betalt.
>
> **user\_id** `string` *required*
>
> ID for affiliatens bruger med præfikset `user_`.

**billing\_period\_days** `integer | null` *required*

Antal dage mellem tilbagevendende opkrævninger. `null` for medlemskaber, der ikke fornyes, eller medlemskaber med flere fornyelsesplaner.

**cancel\_at\_period\_end** `boolean` *required*

Om medlemskabet er indstillet til at blive opsagt, når den aktuelle faktureringsperiode slutter. Kun meningsfuldt for tilbagevendende varianter.

**cancel\_option** `string | null` *required*

Den kategori, medlemmet valgte som årsag til opsigelsen. `null`, når der ikke blev valgt en kategori.

Tilgængelige muligheder: `too_expensive`, `switching`, `missing_features`, `technical_issues`, `bad_experience`, `unused`, `other`, `testing`

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

Hvornår opsigelsen blev anmodet om, eller hvornår medlemskabet blev opsagt, hvis der ikke er registreret et anmodningstidspunkt, som et ISO 8601-tidsstempel. `null`, når ingen af delene er registreret.

**cancellation\_reason** `string | null` *required*

Fritekstforklaring angivet ved opsigelse. `null`, når der ikke blev angivet en årsag.

**collection\_method** `string | null` *required*

Hvordan fornyelser opkræves. `charge_automatically` opkræver den gemte betalingsmetode hver periode; `send_invoice` e-mailer køberen en faktura hver periode. `null`, når den ikke er angivet.

Tilgængelige muligheder: `charge_automatically`, `send_invoice`

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

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

**current\_period\_end** `string | null` *required*

Hvornår den aktuelle faktureringsperiode fornyes, eller hvornår et medlemskab uden fornyelse udløber, som et ISO 8601-tidsstempel. `null` for engangskøb uden udløb.

**current\_period\_start** `string | null` *required*

Hvornår den aktuelle faktureringsperiode startede, som et ISO 8601-tidsstempel. `null`, når der ikke er registreret en faktureringsperiode.

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

Hvornår adgangen slutter for et medlemskab med en fast udløbsdato, som et ISO 8601-tidsstempel. `null`, når medlemskabet ikke har noget udløb, såsom et medlemskab, der fornyes.

**external\_accounts** `object[] | null` *required*

Medlemmets konti på eksterne platforme, såsom Discord og Telegram. Tom, når medlemmet ikke har nogen tilknyttet. `null` i webhooks.

> [accordion] Egenskaber
>
> **external\_id** `string` *required*
>
> Medlemmets bruger-ID på platformen, såsom et Discord-bruger-ID. Med platformen som præfiks (`discord_\<external_id>`) er det den `external_account`-værdi, som List Memberships filtrerer efter.
>
> **platform** `string` *required*
>
> Platformen, som medlemmets konto er på.
>
> Tilgængelige muligheder: `discord`, `telegram`
>
> **username** `string | null` *required*
>
> Medlemmets brugernavn på platformen. `null`, når Whop ikke kender det, såsom for et medlemskab importeret med kun et Discord-ID.

**feedback\_option** `object | null` *required*

Kontoens egen opsigelsesårsag, som medlemmet valgte, sådan som de så den. `null`, når medlemmet valgte en standardkategori eller ikke angav nogen årsag.

> [accordion] Egenskaber
>
> **label** `string` *required*
>
> Valgmulighedens etiket, da medlemmet valgte den. En senere omdøbning af valgmuligheden ændrer den ikke.

**initial\_price** `object` *required*

Variantens aktuelle forudbetalte pris i variantens valuta. En listepris, ikke nødvendigvis hvad køberen betalte. `amount` er `"0.00"`, når den første opkrævning er gratis.

> [accordion] Egenskaber
>
> **amount** `string` *required*
>
> Beløbet i hovedenheder som en eksakt decimalstreng. For eksempel er `"10.00"` ti dollars. Det er en streng, så ingen float afrunder det under overførslen.
>
> **currency** `string` *required*
>
> Trebogstavs ISO 4217-valutakode med små bogstaver.
>
> **decimals** `integer` *required*
>
> Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
>
> **display\_decimals** `integer` *required*
>
> Hvor mange decimaler der skal VISES. Normalt lig med `decimals`, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er `2` og `0`. Formatér tallet i din egen locale ved hjælp af dette.

**license\_key** `string | null` *required*

Softwarelicensnøglen for dette medlemskab. Kun til stede, når produktet inkluderer en softwarelicensoplevelse.

**manage\_url** `string | null` *required*

URL, hvor køberen kan logge ind for at administrere fakturering. `null` uden en medlemspost, eller medmindre kalderen er køberen eller har `member:manage` på kontoen.

**member** `object | null` *required*

Kalderens medlemsrække på kontoen. Kun til stede, når medlemskabet tilhører kalderen; `null` ved læsninger fra sælgersiden.

> [accordion] Egenskaber
>
> **access\_level** `string` *required*
>
> Hvad medlemmet har adgang til på kontoen: `customer` for betalende medlemmer, `admin` for teammedlemmer, `no_access` når alle tildelinger er udløbet.
>
> Tilgængelige muligheder: `no_access`, `admin`, `customer`
>
> **last\_accessed\_at** `string | null` *required*
>
> Hvornår medlemmet sidst åbnede kontoens indhold, som et ISO 8601-tidsstempel. `null`, hvis de aldrig har gjort det.
>
> **position** `number | null` *required*
>
> Medlemmets sorteringsposition i køberens egen kontoliste. `null`, indtil de arrangerer den.

**member\_id** `string | null` *required*

Køberens medlemspost på kontoen med præfikset `mber_`. `null`, når medlemskabet ikke har nogen medlemspost, såsom et uindløst medlemskab.

**metadata** `object` *required*

Tilpassede nøgle-værdi-par gemt på medlemskabet, ofte brugt til softwarelicensering.

**most\_recent\_action** `string | null` *required*

Medlemskabets seneste livscyklushændelse, såsom `renewing_on` eller `canceled_on`. Brug den sammen med `most_recent_action_at`. `null`, når der ikke er registreret nogen.

Tilgængelige muligheder: `canceled_on`, `finished_split_pay_at`, `canceling_on`, `ending_on`, `renewing_on`, `past_due`, `next_payment_attempt`, `paused_at`, `trial_ends_at`, `unresolved_at`, `trial_canceling_on`

**most\_recent\_action\_at** `string | null` *required*

Hvornår `most_recent_action` skete eller er planlagt til at ske, som et ISO 8601-tidsstempel. Et fremtidigt tidspunkt for kommende hændelser såsom `renewing_on`. `null`, når der ikke er registreret nogen handling.

**phone\_number** `string | null` *required*

Køberens telefonnummer registreret for dette medlemskab, eller `null`. Det nummer, der blev indsamlet (eller verificeret) ved checkout, når sælgerens telefonindsamling er slået til; falder tilbage til køberens kontonummer, når de har delt et med denne sælger.

**product** `object` *required*

Produktet, som dette medlemskab giver adgang til.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Produkt-ID med præfikset `prod_`.
>
> **logo\_url** `string | null` *required*
>
> URL til produktets logobillede. `null`, når produktet ikke har noget logo.
>
> **title** `string` *required*
>
> Produktets visningsnavn.

**product\_id** `string` *required*

Produktet, som dette medlemskab giver adgang til, med præfikset `prod_`.

**promo\_code\_id** `string | null` *required*

Rabatkoden, der giver rabat på dette medlemskab, med præfikset `promo_`. `null`, når der ikke er anvendt nogen. Angives ved checkout eller af Apply Promo Code to Membership.

**renewal\_price** `object | null` *required*

Variantens fornyelsespris i variantens valuta efter en eventuel rabatkode, der stadig gælder. Et medlemskab, der faktureres i køberens lokale valuta, opkræves denne pris omregnet til vekselkursen på hver faktureringsdato. `null` for medlemskaber, der ikke fornyes.

> [accordion] Egenskaber
>
> **amount** `string` *required*
>
> Beløbet i hovedenheder som en eksakt decimalstreng. For eksempel er `"10.00"` ti dollars. Det er en streng, så ingen float afrunder det under overførslen.
>
> **currency** `string` *required*
>
> Trebogstavs ISO 4217-valutakode med små bogstaver.
>
> **decimals** `integer` *required*
>
> Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
>
> **display\_decimals** `integer` *required*
>
> Hvor mange decimaler der skal VISES. Normalt lig med `decimals`, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er `2` og `0`. Formatér tallet i din egen locale ved hjælp af dette.

**split\_pay\_current\_payments** `integer | null` *required*

Betalte rater, der indtil videre er talt med på et medlemskab med opdelt betaling. `null`, når medlemskabet ikke har opdelt betaling, eller før dets første rate er talt med.

**split\_pay\_required\_payments** `integer | null` *required*

Ratebetalinger, der kræves, før medlemskabet stopper faktureringen. `null`, når medlemskabet ikke har opdelt betaling.

**status** `string` *required*

Medlemskabets faktureringstilstand. Medlemskaber med `active`/`trialing` giver adgang; `past_due` er henstandsperioden efter en mislykket betaling; engangskøb med `completed` beholder adgangen; `canceled`/`expired` gør ikke.

Tilgængelige muligheder: `trialing`, `active`, `past_due`, `completed`, `canceled`, `expired`, `unresolved`

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

Hvornår medlemskabet sidst blev ændret, som et ISO 8601-tidsstempel. Afspejler den seneste ændring af selve medlemskabet, så du kan afstemme mod webhook-genforsøg, genafspilninger og backfills.

**user\_id** `string | null` *required*

Køberen med præfikset `user_`. `null`, når køberen er en anden virksomhed, eller medlemskabet ikke er indløst.

**variant\_id** `string` *required*

Den variant, køberen købte, med præfikset `plan_`.

```json Membership theme={null}
{
	"id": "mem_xxxxxxxxxxxxxx",
	"affiliate": null,
	"status": "active",
	"collection_method": "charge_automatically",
	"most_recent_action": "renewing_on",
	"most_recent_action_at": "2026-08-01T00:00:00.000Z",
	"user_id": "user_xxxxxxxxxxxxx",
	"product_id": "prod_xxxxxxxxxxxxx",
	"variant_id": "plan_xxxxxxxxxxxxx",
	"member_id": "mber_xxxxxxxxxxxxx",
	"product": {
		"id": "prod_xxxxxxxxxxxxx",
		"title": "Pickaxe Pro",
		"logo_url": "https://cdn.whop.com/product.png"
	},
	"initial_price": {
		"currency": "usd",
		"amount": "0.00",
		"decimals": 2,
		"display_decimals": 2
	},
	"renewal_price": {
		"currency": "usd",
		"amount": "50.00",
		"decimals": 2,
		"display_decimals": 2
	},
	"split_pay_current_payments": null,
	"split_pay_required_payments": null,
	"expires_at": null,
	"promo_code_id": null,
	"billing_period_days": 30,
	"license_key": "A1B2C3-D4E5F6-G7H8I9",
	"phone_number": "+12025550123",
	"cancel_at_period_end": false,
	"current_period_start": "2026-07-01T00:00:00.000Z",
	"current_period_end": "2026-08-01T00:00:00.000Z",
	"canceled_at": null,
	"cancel_option": null,
	"cancellation_reason": null,
	"feedback_option": null,
	"external_accounts": [
		{
			"platform": "discord",
			"external_id": "123456789012345678",
			"username": "jane"
		}
	],
	"manage_url": "https://whop.com/billing/manage/mber_xxxxxxxxxxxxx",
	"metadata": {
		"external_customer_id": "cus_123"
	},
	"created_at": "2026-07-01T00:00:00.000Z",
	"updated_at": "2026-07-15T00:00:00.000Z",
	"member": {
		"access_level": "customer",
		"last_accessed_at": "2026-07-20T15:30:00.000Z",
		"position": 1
	},
	"account": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Pickaxe",
		"route": "pickaxe",
		"logo_url": "https://cdn.whop.com/account.png"
	}
}
```


## Related topics

- [Cancel membership](https://docs.whop.com/da/api-reference/legacy/memberships/cancel-membership.md)
- [Transfer Membership](https://docs.whop.com/da/api-reference/memberships/transfer-membership.md)
- [List memberships](https://docs.whop.com/da/api-reference/legacy/memberships/list-memberships.md)
