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

# Members API

> Een Member is de relatie van één koper met een account: één record per klant, ongeacht hoeveel lidmaatschappen die heeft.

Het houdt bij of ze lid zijn geworden of zijn vertrokken, hun toegangsniveau, en wanneer ze voor het laatst de content van het account hebben geopend.

Gebruik de Members API om de leden van een account weer te geven en te doorzoeken, één lid op te halen en het activiteitenlogboek van een lid te lezen. Ledenrijen worden aangemaakt en bijgehouden door de levenscyclus van lidmaatschappen; werk in plaats daarvan met lidmaatschappen om toegang te verlenen of in te trekken.

> [!NOTE]
>
> Vervangt de Legacy-resource [Members](https://docs.whop.com/nl/api-reference/members/member). Bestaande Legacy-integraties blijven werken; zie [API-versies](https://docs.whop.com/nl/developer/api/versioning.md) voor de stabiliteitsgarantie.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Leden weergeven](https://docs.whop.com/nl/api-reference/members/list-members.md) | GET `/members` |
| [Lid ophalen](https://docs.whop.com/nl/api-reference/members/retrieve-member.md) | GET `/members/{id}` |
| [Ledenlogboeken weergeven](https://docs.whop.com/nl/api-reference/members/list-member-logs.md) | GET `/members/{id}/logs` |
| [Ledennotities weergeven](https://docs.whop.com/nl/api-reference/members/list-member-notes.md) | GET `/members/{member_id}/notes` |
| [Lid aanmaken](https://docs.whop.com/nl/api-reference/members/create-member.md) | POST `/members` |
| [Ledennotitie aanmaken](https://docs.whop.com/nl/api-reference/members/create-member-note.md) | POST `/members/{member_id}/notes` |
| [Lid uitschrijven](https://docs.whop.com/nl/api-reference/members/unsubscribe-member.md) | POST `/members/{id}/unsubscribe` |
| [Lid bijwerken](https://docs.whop.com/nl/api-reference/members/update-member.md) | PATCH `/members/{id}` |

## Attributen

**id** `string` *required*

Lid-ID, met prefix `mber_`.

**access\_level** `string` *required*

Waartoe het lid toegang heeft op het account: `customer` voor betalende leden, `admin` voor teamleden, `no_access` zodra elke toekenning is verlopen.

Beschikbare opties: `no_access`, `admin`, `customer`

**account\_id** `string` *required*

Het account waartoe dit lid behoort, met prefix `biz_`.

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

Wanneer het ledenrecord is aangemaakt, als ISO 8601-tijdstempel.

**display\_name** `string` *required*

De naam die voor dit lid wordt getoond: de naam van de gebruiker, of de gebruikersnaam als die geen naam heeft ingesteld. De naam van het kopende bedrijf wanneer `user` `null` is.

**earnings\_usd** `object | null` *required*

Het bruto-inkomen van de gebruiker op Whop, in USD, periodiek bijgewerkt. `null` wanneer de gebruiker de inkomsten verbergt of de koper een ander bedrijf is.

> [accordion] Eigenschappen
>
> **last\_24\_hours** `string` *required*
>
> Bruto-inkomen in USD over de afgelopen 24 uur.
>
> **last\_30\_days** `string` *required*
>
> Bruto-inkomen in USD over de afgelopen 30 dagen.
>
> **last\_7\_days** `string` *required*
>
> Bruto-inkomen in USD over de afgelopen 7 dagen.
>
> **lifetime** `string` *required*
>
> Totaal bruto-inkomen in USD.

**email** `string | null` *required*

Het e-mailadres van de gebruiker. `null` zonder `member:email:read` op het account, wanneer de koper een ander bedrijf is, of wanneer de gebruiker geen toegewezen e-mailadres heeft.

**joined\_at** `string` *required*

Wanneer het lid voor het eerst lid werd van het account, als ISO 8601-tijdstempel.

**last\_accessed\_at** `string | null` *required*

Wanneer het lid voor het laatst de content van het account heeft geopend, als ISO 8601-tijdstempel. `null` als dat nooit is gebeurd.

**last\_activity** `message | null` *required*

Wat er gebeurde op `last_activity_at`. `object` geeft aan om welk soort activiteit het gaat. `null` zonder `support_chat:read` op het account, of wanneer `last_activity_at` `null` is.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> De bericht-ID.
>
> **author** `object | null` *required*
>
> Wie het bericht heeft verzonden: het lid, of iemand van het team van het account. `null` wanneer het account van de afzender niet meer bestaat.
>
> > [accordion] Eigenschappen
> >
> > **id** `string` *required*
> >
> > Gebruikers-ID, met prefix `user_`.
> >
> > **name** `string | null` *required*
> >
> > Weergavenaam.
> >
> > **profile\_picture** `object` *required*
> >
> > Avatar-wrapper. De `url` is altijd aanwezig en is een gegenereerde placeholder wanneer de gebruiker geen afbeelding heeft ingesteld.
> >
> > > [accordion] Eigenschappen
> > >
> > > **url** `string` *required*
> > >
> > > URL van de avatarafbeelding. Altijd aanwezig. Het is een gegenereerde placeholder wanneer de gebruiker geen afbeelding heeft ingesteld.
> >
> > **username** `string` *required*
> >
> > Openbare gebruikersnaam.
>
> **channel\_id** `string` *required*
>
> De supportchat waarin het bericht is verzonden.
>
> **created\_at** `string` *required*
>
> Wanneer het bericht is verzonden, als ISO 8601-tijdstempel.
>
> **object** `string` *required*
>
> Altijd `message`.
>
> **plain\_content** `string | null` *required*
>
> De berichttekst zonder opmaak. `null` wanneer het bericht geen tekst heeft, zoals een losse bijlage.

**last\_activity\_at** `string | null` *required*

Wanneer het lid en het account voor het laatst interactie hadden, als ISO 8601-tijdstempel. Bijvoorbeeld een bericht in de supportchat van het lid.

**metadata** `object | null` *required*

Je eigen sleutel-waardegegevens die op dit lid zijn opgeslagen. `null` wanneer er niets is ingesteld.

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

De meest recente levenscyclusstatus van het lid op het account, afgeleid van hun lidmaatschappen, zoals `paid_subscriber`, `canceling` of `churned`. `null` totdat deze voor het eerst is berekend.

Beschikbare opties: `canceling`, `churned`, `finished_split_pay`, `paused`, `paid_subscriber`, `paid_once`, `expiring`, `joined`, `left`, `trialing`, `pending_entry`, `renewing`, `past_due`

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

Wanneer `most_recent_action` van kracht werd, als ISO 8601-tijdstempel. `null` wanneer `most_recent_action` `null` is.

**name** `string | null` *required*

De naam die het account aan deze klant heeft gegeven met `PATCH /members/:id`. Facturen tonen deze als klantnaam op elke factuur voor dit lid, in plaats van de eigen naam van de gebruiker. `null` wanneer het account er geen heeft ingesteld.

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

Het telefoonnummer van het lid: het meest recente nummer dat bij de checkout is verzameld (of geverifieerd), anders hun accountnummer als ze dat met deze verkoper hebben gedeeld. `null` zonder `member:phone:read` op het account, of wanneer geen van beide bestaat.

**status** `string` *required*

`joined` zolang het lid deel uitmaakt van het account, `left` nadat het lid is vertrokken.

Beschikbare opties: `joined`, `left`

**token\_balance** `number` *required*

Het huidige tokensaldo van het lid voor dit account, berekend op basis van tokentransacties.

**unsubscribe\_status** `string | null` *required*

`unsubscribed` zodra het lid zich afmeldt voor de marketingcommunicatie van het account, `null` zolang het lid is aangemeld. Alleen het lid kan dit wijzigen.

Beschikbare opties: `unsubscribed`

**usd\_total\_spent** `object` *required*

Hoeveel het lid heeft uitgegeven aan de producten van het account, in USD.

> [accordion] Eigenschappen
>
> **amount** `string` *required*
>
> Het bedrag in hoofdeenheden, als exacte decimale string. Bijvoorbeeld: `"10.00"` is tien dollar. Het is een string zodat geen enkele float het onderweg afrondt.
>
> **currency** `string` *required*
>
> Drieletterige ISO 4217-valutacode, in kleine letters.
>
> **decimals** `integer` *required*
>
> Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de afschrijving zelf wordt uitgevoerd.
>
> **display\_decimals** `integer` *required*
>
> Hoeveel decimalen er moeten worden GETOOND. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt afgeschreven in centavos maar geschreven in hele peso's, dus is het `2` en `0`. Maak het getal hiermee op in je eigen locale.

**user** `object | null` *required*

De gebruiker achter dit lid. `null` wanneer de koper een ander bedrijf is in plaats van een persoon.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Gebruikers-ID, met prefix `user_`.
>
> **city** `string | null` *required*
>
> De plaats van de gebruiker, afgeleid van hun IP-adres. `null` wanneer onbekend of wanneer de gebruiker locatiedeling heeft uitgeschakeld.
>
> **country** `string | null` *required*
>
> Het land van de gebruiker als ISO 3166-1 alpha-2-code, zoals `US`, afgeleid van hun IP-adres. `null` wanneer onbekend of wanneer de gebruiker locatiedeling heeft uitgeschakeld.
>
> **name** `string | null` *required*
>
> Weergavenaam.
>
> **profile\_picture** `object` *required*
>
> Avatar-wrapper. De `url` is altijd aanwezig en is een gegenereerde placeholder wanneer de gebruiker geen afbeelding heeft ingesteld.
>
> > [accordion] Eigenschappen
> >
> > **url** `string` *required*
> >
> > URL van de avatarafbeelding. Altijd aanwezig. Het is een gegenereerde placeholder wanneer de gebruiker geen afbeelding heeft ingesteld.
>
> **state** `string | null` *required*
>
> De staat- of regiocode van de gebruiker, zoals `CA`, afgeleid van hun IP-adres. `null` wanneer onbekend of wanneer de gebruiker locatiedeling heeft uitgeschakeld.
>
> **username** `string` *required*
>
> Openbare gebruikersnaam.

```json Member theme={null}
{
	"id": "mber_xxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"access_level": "customer",
	"status": "joined",
	"display_name": "Jane Doe",
	"name": "Doe Legal LLP",
	"email": "jane@example.com",
	"most_recent_action": "paid_subscriber",
	"most_recent_action_at": "2026-07-01T00:00:00.000Z",
	"usd_total_spent": {
		"currency": "usd",
		"amount": "150.00",
		"decimals": 2,
		"display_decimals": 2
	},
	"token_balance": 70.25,
	"earnings_usd": {
		"lifetime": "4120.25",
		"last_30_days": "260.00",
		"last_7_days": "60.00",
		"last_24_hours": "12.50"
	},
	"phone_number": "+12025550123",
	"joined_at": "2026-07-01T00:00:00.000Z",
	"last_accessed_at": "2026-07-20T15:30:00.000Z",
	"last_activity_at": "2026-07-18T09:12:00.000Z",
	"last_activity": {
		"id": "post_xxxxxxxxxxxxx",
		"object": "message",
		"channel_id": "feed_xxxxxxxxxxxxx",
		"author": {
			"id": "user_xxxxxxxxxxxxx",
			"username": "janedoe",
			"name": "Jane Doe",
			"profile_picture": {
				"url": "https://cdn.whop.com/user.png"
			}
		},
		"plain_content": "Hey, my access stopped working",
		"created_at": "2026-07-18T09:12:00.000Z"
	},
	"unsubscribe_status": null,
	"metadata": {
		"crm_owner": "jordan",
		"deal_stage": "qualified"
	},
	"created_at": "2026-07-01T00:00:00.000Z",
	"user": {
		"id": "user_xxxxxxxxxxxxx",
		"username": "janedoe",
		"name": "Jane Doe",
		"profile_picture": {
			"url": "https://cdn.whop.com/user.png"
		},
		"city": "Austin",
		"state": "TX",
		"country": "US"
	}
}
```


## Related topics

- [Team Members API](https://docs.whop.com/nl/api-reference/team-members/team-member.md)
- [Channel Members API](https://docs.whop.com/nl/api-reference/channel-members/channel-member.md)
- [Permissions API](https://docs.whop.com/nl/api-reference/permissions/permission.md)
