> ## 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 de miembros

> Un Member es la relación de un comprador con una cuenta: un registro por cliente, sin importar cuántas membresías tenga.

Registra si se ha unido o se ha ido, su nivel de acceso y cuándo abrió por última vez el contenido de la cuenta.

Usa la API de miembros para listar y buscar los miembros de una cuenta, recuperar un solo miembro y leer el registro de actividad de un miembro. Las filas de miembros se crean y mantienen mediante el ciclo de vida de las membresías; para conceder o revocar el acceso, trabaja con las membresías.

> [!NOTE]
>
> Reemplaza el recurso heredado [Members](https://docs.whop.com/es/api-reference/members/member). Las integraciones heredadas existentes siguen funcionando; consulta [Versiones de la API](https://docs.whop.com/es/developer/api/versioning.md) para conocer el compromiso de estabilidad.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar miembros](https://docs.whop.com/es/api-reference/members/list-members.md) | GET `/members` |
| [Recuperar miembro](https://docs.whop.com/es/api-reference/members/retrieve-member.md) | GET `/members/{id}` |
| [Listar registros de miembros](https://docs.whop.com/es/api-reference/members/list-member-logs.md) | GET `/members/{id}/logs` |
| [Listar notas de miembros](https://docs.whop.com/es/api-reference/members/list-member-notes.md) | GET `/members/{member_id}/notes` |
| [Crear miembro](https://docs.whop.com/es/api-reference/members/create-member.md) | POST `/members` |
| [Crear nota de miembro](https://docs.whop.com/es/api-reference/members/create-member-note.md) | POST `/members/{member_id}/notes` |
| [Cancelar suscripción de miembro](https://docs.whop.com/es/api-reference/members/unsubscribe-member.md) | POST `/members/{id}/unsubscribe` |
| [Actualizar miembro](https://docs.whop.com/es/api-reference/members/update-member.md) | PATCH `/members/{id}` |

## Atributos

**id** `string` *required*

ID del miembro, con el prefijo `mber_`.

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

A qué puede acceder el miembro en la cuenta: `customer` para miembros que pagan, `admin` para miembros del equipo, `no_access` una vez que han caducado todas las concesiones.

Opciones disponibles: `no_access`, `admin`, `customer`

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

La cuenta a la que pertenece este miembro, con el prefijo `biz_`.

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

Cuándo se creó el registro del miembro, como marca de tiempo ISO 8601.

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

El nombre que se mostrará para este miembro: el nombre del usuario, o su nombre de usuario cuando no ha establecido uno. El nombre de la empresa compradora cuando `user` es `null`.

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

Los ingresos brutos del usuario en Whop, en USD, actualizados periódicamente. `null` cuando el usuario oculta sus ganancias o el comprador es otra empresa.

> [accordion] Propiedades
>
> **last\_24\_hours** `string` *required*
>
> Ingresos brutos en USD en las últimas 24 horas.
>
> **last\_30\_days** `string` *required*
>
> Ingresos brutos en USD en los últimos 30 días.
>
> **last\_7\_days** `string` *required*
>
> Ingresos brutos en USD en los últimos 7 días.
>
> **lifetime** `string` *required*
>
> Ingresos brutos históricos en USD.

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

La dirección de correo electrónico del usuario. `null` sin `member:email:read` en la cuenta, cuando el comprador es otra empresa o cuando el usuario no tiene ningún correo asignado.

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

Cuándo se unió el miembro por primera vez a la cuenta, como marca de tiempo ISO 8601.

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

Cuándo abrió el miembro por última vez el contenido de la cuenta, como marca de tiempo ISO 8601. `null` si nunca lo ha hecho.

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

Qué ocurrió en `last_activity_at`. `object` indica de qué tipo de actividad se trata. `null` sin `support_chat:read` en la cuenta, o cuando `last_activity_at` es `null`.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> El ID del mensaje.
>
> **author** `object | null` *required*
>
> Quién envió el mensaje: el miembro o alguien del equipo de la cuenta. `null` cuando la cuenta del remitente ya no existe.
>
> > [accordion] Propiedades
> >
> > **id** `string` *required*
> >
> > ID del usuario, con el prefijo `user_`.
> >
> > **name** `string | null` *required*
> >
> > Nombre visible.
> >
> > **profile\_picture** `object` *required*
> >
> > Contenedor del avatar. Su `url` siempre está presente y es un marcador de posición generado cuando el usuario no ha establecido ninguna imagen.
> >
> > > [accordion] Propiedades
> > >
> > > **url** `string` *required*
> > >
> > > URL de la imagen del avatar. Siempre presente. Es un marcador de posición generado cuando el usuario no ha establecido ninguna imagen.
> >
> > **username** `string` *required*
> >
> > Nombre de usuario público.
>
> **channel\_id** `string` *required*
>
> El chat de soporte en el que se envió el mensaje.
>
> **created\_at** `string` *required*
>
> Cuándo se envió el mensaje, como marca de tiempo ISO 8601.
>
> **object** `string` *required*
>
> Siempre `message`.
>
> **plain\_content** `string | null` *required*
>
> El texto del mensaje sin formato. `null` cuando el mensaje no tiene texto, como un adjunto por sí solo.

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

Cuándo interactuaron por última vez el miembro y la cuenta, como marca de tiempo ISO 8601. Por ejemplo, un mensaje en el chat de soporte del miembro.

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

Tus propios datos clave-valor almacenados en este miembro. `null` cuando no se ha establecido ninguno.

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

El estado más reciente del ciclo de vida del miembro en la cuenta, derivado de sus membresías, como `paid_subscriber`, `canceling` o `churned`. `null` hasta que se calcula por primera vez.

Opciones 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*

Cuándo entró en vigor `most_recent_action`, como marca de tiempo ISO 8601. `null` cuando `most_recent_action` es `null`.

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

El nombre que la cuenta le dio a este cliente con `PATCH /members/:id`. Las facturas lo muestran como nombre del cliente en todas las facturas de este miembro, en lugar del nombre propio del usuario. `null` cuando la cuenta no ha establecido uno.

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

El número de teléfono del miembro: el número más reciente recopilado (o verificado) en el checkout o, en su defecto, el número de su cuenta cuando lo ha compartido con este vendedor. `null` sin `member:phone:read` en la cuenta, o cuando no hay ninguno.

**status** `string` *required*

`joined` mientras el miembro forma parte de la cuenta, `left` después de que se vaya.

Opciones disponibles: `joined`, `left`

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

El saldo de tokens actual del miembro para esta cuenta, calculado a partir de las transacciones de tokens.

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

`unsubscribed` una vez que el miembro se da de baja de las comunicaciones de marketing de la cuenta, `null` mientras esté suscrito. Solo el miembro puede cambiarlo.

Opciones disponibles: `unsubscribed`

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

Cuánto ha gastado el miembro en los productos de la cuenta, en USD.

> [accordion] Propiedades
>
> **amount** `string` *required*
>
> El importe en unidades principales, como una cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de punto flotante lo redondee durante la transmisión.
>
> **currency** `string` *required*
>
> Código de moneda ISO 4217 de tres letras, en minúsculas.
>
> **decimals** `integer` *required*
>
> Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cobro.
>
> **display\_decimals** `integer` *required*
>
> Cuántos decimales MOSTRAR. Normalmente igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, así que es `2` y `0`. Usa este valor para dar formato al número en tu propia configuración regional.

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

El usuario detrás de este miembro. `null` cuando el comprador es otra empresa en lugar de una persona.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del usuario, con el prefijo `user_`.
>
> **city** `string | null` *required*
>
> La ciudad del usuario, derivada de su dirección IP. `null` cuando se desconoce o el usuario desactivó el uso compartido de la ubicación.
>
> **country** `string | null` *required*
>
> El país del usuario como código ISO 3166-1 alfa-2, como `US`, derivado de su dirección IP. `null` cuando se desconoce o el usuario desactivó el uso compartido de la ubicación.
>
> **name** `string | null` *required*
>
> Nombre visible.
>
> **profile\_picture** `object` *required*
>
> Contenedor del avatar. Su `url` siempre está presente y es un marcador de posición generado cuando el usuario no ha establecido ninguna imagen.
>
> > [accordion] Propiedades
> >
> > **url** `string` *required*
> >
> > URL de la imagen del avatar. Siempre presente. Es un marcador de posición generado cuando el usuario no ha establecido ninguna imagen.
>
> **state** `string | null` *required*
>
> El código de estado o región del usuario, como `CA`, derivado de su dirección IP. `null` cuando se desconoce o el usuario desactivó el uso compartido de la ubicación.
>
> **username** `string` *required*
>
> Nombre de usuario público.

```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 de Automations](https://docs.whop.com/es/api-reference/automations/automation.md)
- [Versiones de la API](https://docs.whop.com/es/developer/api/versioning.md)
- [API de Exports](https://docs.whop.com/es/api-reference/exports/export.md)
