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

# API Members

> Un Member représente la relation d'un acheteur avec un compte : un enregistrement par client, quel que soit le nombre d'abonnements qu'il détient.

Il indique s'il a rejoint ou quitté le compte, son niveau d'accès et la dernière fois qu'il a ouvert le contenu du compte.

Utilisez l'API Members pour lister et rechercher les membres d'un compte, récupérer un membre et consulter le journal d'activité d'un membre. Les enregistrements de membres sont créés et gérés par le cycle de vie des abonnements ; pour accorder ou révoquer un accès, utilisez plutôt les abonnements.

> [!NOTE]
>
> Remplace la ressource Legacy [Members](https://docs.whop.com/fr/api-reference/members/member). Les intégrations Legacy existantes continuent de fonctionner ; consultez [Versions de l'API](https://docs.whop.com/fr/developer/api/versioning.md) pour le contrat de stabilité.

## Endpoints

| Endpoint | Requête |
| - | - |
| [List Members](https://docs.whop.com/fr/api-reference/members/list-members.md) | GET `/members` |
| [Retrieve Member](https://docs.whop.com/fr/api-reference/members/retrieve-member.md) | GET `/members/{id}` |
| [List Member Logs](https://docs.whop.com/fr/api-reference/members/list-member-logs.md) | GET `/members/{id}/logs` |
| [List Member Notes](https://docs.whop.com/fr/api-reference/members/list-member-notes.md) | GET `/members/{member_id}/notes` |
| [Create Member](https://docs.whop.com/fr/api-reference/members/create-member.md) | POST `/members` |
| [Create Member Note](https://docs.whop.com/fr/api-reference/members/create-member-note.md) | POST `/members/{member_id}/notes` |
| [Unsubscribe Member](https://docs.whop.com/fr/api-reference/members/unsubscribe-member.md) | POST `/members/{id}/unsubscribe` |
| [Update Member](https://docs.whop.com/fr/api-reference/members/update-member.md) | PATCH `/members/{id}` |

## Attributs

**id** `string` *required*

ID du membre, préfixé par `mber_`.

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

Ce à quoi le membre peut accéder sur le compte : `customer` pour les membres payants, `admin` pour les membres de l'équipe, `no_access` une fois que tous les accès ont expiré.

Options disponibles : `no_access`, `admin`, `customer`

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

Le compte auquel appartient ce membre, préfixé par `biz_`.

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

Date de création de l'enregistrement du membre, sous forme de timestamp ISO 8601.

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

Le nom à afficher pour ce membre : le nom de l'utilisateur, ou son nom d'utilisateur s'il n'a pas défini de nom. Le nom de l'entreprise acheteuse lorsque `user` vaut `null`.

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

Le revenu brut de l'utilisateur sur Whop, en USD, actualisé périodiquement. `null` lorsque l'utilisateur masque ses gains ou que l'acheteur est une autre entreprise.

> [accordion] Properties
>
> **last\_24\_hours** `string` *required*
>
> Revenu brut en USD sur les dernières 24 heures.
>
> **last\_30\_days** `string` *required*
>
> Revenu brut en USD sur les 30 derniers jours.
>
> **last\_7\_days** `string` *required*
>
> Revenu brut en USD sur les 7 derniers jours.
>
> **lifetime** `string` *required*
>
> Revenu brut en USD depuis le début.

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

L'adresse e-mail de l'utilisateur. `null` sans `member:email:read` sur le compte, lorsque l'acheteur est une autre entreprise, ou lorsque l'utilisateur n'a pas d'adresse e-mail attribuée.

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

Date à laquelle le membre a rejoint le compte pour la première fois, sous forme de timestamp ISO 8601.

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

Date à laquelle le membre a ouvert le contenu du compte pour la dernière fois, sous forme de timestamp ISO 8601. `null` s'il ne l'a jamais fait.

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

Ce qui s'est passé à `last_activity_at`. `object` indique de quel type d'activité il s'agit. `null` sans `support_chat:read` sur le compte, ou lorsque `last_activity_at` vaut `null`.

> [accordion] Properties
>
> **id** `string` *required*
>
> L'ID du message.
>
> **author** `object | null` *required*
>
> L'expéditeur du message : le membre ou une personne de l'équipe du compte. `null` lorsque le compte de l'expéditeur n'existe plus.
>
> > [accordion] Properties
> >
> > **id** `string` *required*
> >
> > ID de l'utilisateur, préfixé par `user_`.
> >
> > **name** `string | null` *required*
> >
> > Nom d'affichage.
> >
> > **profile\_picture** `object` *required*
> >
> > Conteneur de l'avatar. Son `url` est toujours présent, et correspond à un espace réservé généré lorsque l'utilisateur n'a défini aucune photo.
> >
> > > [accordion] Properties
> > >
> > > **url** `string` *required*
> > >
> > > URL de l'image de l'avatar. Toujours présente. Il s'agit d'un espace réservé généré lorsque l'utilisateur n'a défini aucune photo.
> >
> > **username** `string` *required*
> >
> > Nom d'utilisateur public.
>
> **channel\_id** `string` *required*
>
> Le chat d'assistance dans lequel le message a été envoyé.
>
> **created\_at** `string` *required*
>
> Date d'envoi du message, sous forme de timestamp ISO 8601.
>
> **object** `string` *required*
>
> Toujours `message`.
>
> **plain\_content** `string | null` *required*
>
> Le texte du message sans mise en forme. `null` lorsque le message ne contient pas de texte, comme une pièce jointe seule.

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

Date de la dernière interaction entre le membre et le compte, sous forme de timestamp ISO 8601. Par exemple, un message dans le chat d'assistance du membre.

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

Vos propres données clé-valeur stockées sur ce membre. `null` lorsqu'aucune n'est définie.

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

Le dernier état du cycle de vie du membre sur le compte, déduit de ses abonnements, comme `paid_subscriber`, `canceling` ou `churned`. `null` jusqu'à son premier calcul.

Options disponibles : `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*

Date à laquelle `most_recent_action` a pris effet, sous forme de timestamp ISO 8601. `null` lorsque `most_recent_action` vaut `null`.

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

Le nom que le compte a attribué à ce client avec `PATCH /members/:id`. Les factures l'affichent comme nom du client sur chaque facture de ce membre, à la place du nom de l'utilisateur. `null` lorsque le compte n'en a pas défini.

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

Le numéro de téléphone du membre : le numéro le plus récent collecté (ou vérifié) lors du checkout, sinon le numéro de son compte lorsqu'il l'a partagé avec ce vendeur. `null` sans `member:phone:read` sur le compte, ou lorsqu'il n'y en a aucun.

**status** `string` *required*

`joined` tant que le membre fait partie du compte, `left` après son départ.

Options disponibles : `joined`, `left`

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

Le solde de tokens actuel du membre pour ce compte, calculé à partir des transactions de tokens.

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

`unsubscribed` dès que le membre se désinscrit des communications marketing du compte, `null` tant qu'il est inscrit. Seul le membre peut le modifier.

Options disponibles : `unsubscribed`

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

Le montant dépensé par le membre pour les produits du compte, en USD.

> [accordion] Properties
>
> **amount** `string` *required*
>
> Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse en transit.
>
> **currency** `string` *required*
>
> Code de devise ISO 4217 à trois lettres, en minuscules.
>
> **decimals** `integer` *required*
>
> Nombre de décimales que comporte le montant. Il s'agit de la précision à laquelle le débit lui-même est effectué.
>
> **display\_decimals** `integer` *required*
>
> Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est débité en centavos mais écrit en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.

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

L'utilisateur derrière ce membre. `null` lorsque l'acheteur est une autre entreprise plutôt qu'une personne.

> [accordion] Properties
>
> **id** `string` *required*
>
> ID de l'utilisateur, préfixé par `user_`.
>
> **city** `string | null` *required*
>
> La ville de l'utilisateur, déduite de son adresse IP. `null` lorsqu'elle est inconnue ou que l'utilisateur a désactivé le partage de localisation.
>
> **country** `string | null` *required*
>
> Le pays de l'utilisateur sous forme de code ISO 3166-1 alpha-2, comme `US`, déduit de son adresse IP. `null` lorsqu'il est inconnu ou que l'utilisateur a désactivé le partage de localisation.
>
> **name** `string | null` *required*
>
> Nom d'affichage.
>
> **profile\_picture** `object` *required*
>
> Conteneur de l'avatar. Son `url` est toujours présent, et correspond à un espace réservé généré lorsque l'utilisateur n'a défini aucune photo.
>
> > [accordion] Properties
> >
> > **url** `string` *required*
> >
> > URL de l'image de l'avatar. Toujours présente. Il s'agit d'un espace réservé généré lorsque l'utilisateur n'a défini aucune photo.
>
> **state** `string | null` *required*
>
> Le code d'État ou de région de l'utilisateur, comme `CA`, déduit de son adresse IP. `null` lorsqu'il est inconnu ou que l'utilisateur a désactivé le partage de localisation.
>
> **username** `string` *required*
>
> Nom d'utilisateur public.

```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

- [API Channel Members](https://docs.whop.com/fr/api-reference/channel-members/channel-member.md)
- [API Team Members](https://docs.whop.com/fr/api-reference/team-members/team-member.md)
- [API Memberships](https://docs.whop.com/fr/api-reference/memberships/membership.md)
