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

> 멤버(Member)는 한 구매자와 계정의 관계입니다. 보유한 멤버십 수와 관계없이 고객당 하나의 레코드가 있습니다.

멤버가 가입했는지 또는 탈퇴했는지, 접근 수준, 그리고 계정의 콘텐츠를 마지막으로 연 시점을 추적합니다.

Members API를 사용하여 계정의 멤버를 조회 및 검색하고, 단일 멤버를 조회하고, 멤버의 활동 로그를 읽을 수 있습니다. 멤버 행은 멤버십 수명 주기에 의해 생성 및 유지되므로, 접근 권한을 부여하거나 취소하려면 대신 멤버십을 사용하세요.

> [!NOTE]
>
> Legacy [Members](https://docs.whop.com/ko/api-reference/members/member) 리소스를 대체합니다. 기존 Legacy 통합은 계속 작동합니다. 안정성 보장에 대해서는 [API 버전](https://docs.whop.com/ko/developer/api/versioning.md)을 참조하세요.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [멤버 목록 조회](https://docs.whop.com/ko/api-reference/members/list-members.md) | GET `/members` |
| [멤버 조회](https://docs.whop.com/ko/api-reference/members/retrieve-member.md) | GET `/members/{id}` |
| [멤버 로그 목록 조회](https://docs.whop.com/ko/api-reference/members/list-member-logs.md) | GET `/members/{id}/logs` |
| [멤버 메모 목록 조회](https://docs.whop.com/ko/api-reference/members/list-member-notes.md) | GET `/members/{member_id}/notes` |
| [멤버 생성](https://docs.whop.com/ko/api-reference/members/create-member.md) | POST `/members` |
| [멤버 메모 생성](https://docs.whop.com/ko/api-reference/members/create-member-note.md) | POST `/members/{member_id}/notes` |
| [멤버 구독 취소](https://docs.whop.com/ko/api-reference/members/unsubscribe-member.md) | POST `/members/{id}/unsubscribe` |
| [멤버 업데이트](https://docs.whop.com/ko/api-reference/members/update-member.md) | PATCH `/members/{id}` |

## 속성

**id** `string` *required*

멤버 ID이며, 접두사는 `mber_`입니다.

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

멤버가 계정에서 접근할 수 있는 범위입니다: 결제 멤버는 `customer`, 팀원은 `admin`, 모든 권한이 만료되면 `no_access`입니다.

사용 가능한 옵션: `no_access`, `admin`, `customer`

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

이 멤버가 속한 계정으로, 접두사는 `biz_`입니다.

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

멤버 레코드가 생성된 시점으로, ISO 8601 타임스탬프입니다.

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

이 멤버에 대해 표시할 이름입니다: 사용자의 이름, 또는 이름을 설정하지 않은 경우 사용자 이름입니다. `user`가 `null`인 경우 구매한 비즈니스의 이름입니다.

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

Whop 전체에서 사용자의 총수입(USD)으로, 주기적으로 갱신됩니다. 사용자가 수입을 숨기거나 구매자가 다른 비즈니스인 경우 `null`입니다.

> [accordion] 속성
>
> **last\_24\_hours** `string` *required*
>
> 최근 24시간 동안의 총수입(USD)입니다.
>
> **last\_30\_days** `string` *required*
>
> 최근 30일 동안의 총수입(USD)입니다.
>
> **last\_7\_days** `string` *required*
>
> 최근 7일 동안의 총수입(USD)입니다.
>
> **lifetime** `string` *required*
>
> 전체 기간 총수입(USD)입니다.

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

사용자의 이메일 주소입니다. 계정에 `member:email:read` 권한이 없거나, 구매자가 다른 비즈니스이거나, 사용자에게 할당된 이메일이 없는 경우 `null`입니다.

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

멤버가 계정에 처음 가입한 시점으로, ISO 8601 타임스탬프입니다.

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

멤버가 계정의 콘텐츠를 마지막으로 연 시점으로, ISO 8601 타임스탬프입니다. 한 번도 연 적이 없는 경우 `null`입니다.

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

`last_activity_at`에 발생한 일입니다. `object`는 활동의 종류를 나타냅니다. 계정에 `support_chat:read` 권한이 없거나 `last_activity_at`이 `null`인 경우 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 메시지 ID입니다.
>
> **author** `object | null` *required*
>
> 메시지를 보낸 사람: 멤버 또는 계정 팀의 누군가입니다. 보낸 사람의 계정이 더 이상 존재하지 않는 경우 `null`입니다.
>
> > [accordion] 속성
> >
> > **id** `string` *required*
> >
> > 사용자 ID이며, 접두사는 `user_`입니다.
> >
> > **name** `string | null` *required*
> >
> > 표시 이름입니다.
> >
> > **profile\_picture** `object` *required*
> >
> > 아바타 래퍼입니다. `url`은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 자리 표시자입니다.
> >
> > > [accordion] 속성
> > >
> > > **url** `string` *required*
> > >
> > > 아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 자리 표시자입니다.
> >
> > **username** `string` *required*
> >
> > 공개 사용자 이름입니다.
>
> **channel\_id** `string` *required*
>
> 메시지가 전송된 지원 채팅입니다.
>
> **created\_at** `string` *required*
>
> 메시지가 전송된 시점으로, ISO 8601 타임스탬프입니다.
>
> **object** `string` *required*
>
> 항상 `message`입니다.
>
> **plain\_content** `string | null` *required*
>
> 서식이 없는 메시지 텍스트입니다. 첨부 파일만 있는 경우처럼 메시지에 텍스트가 없으면 `null`입니다.

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

멤버와 계정이 마지막으로 상호작용한 시점으로, ISO 8601 타임스탬프입니다. 예를 들어 멤버의 지원 채팅에서 보낸 메시지가 있습니다.

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

이 멤버에 저장된 사용자 고유의 키-값 데이터입니다. 설정된 것이 없는 경우 `null`입니다.

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

멤버십에서 파생된, 계정에서 멤버의 최신 수명 주기 상태로, `paid_subscriber`, `canceling`, `churned` 등이 있습니다. 처음 계산될 때까지 `null`입니다.

사용 가능한 옵션: `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*

`most_recent_action`이 적용된 시점으로, ISO 8601 타임스탬프입니다. `most_recent_action`이 `null`인 경우 `null`입니다.

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

계정이 `PATCH /members/:id`로 이 고객에게 지정한 이름입니다. 이 멤버의 모든 인보이스에서 사용자 본인의 이름 대신 고객 이름으로 표시됩니다. 계정이 설정하지 않은 경우 `null`입니다.

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

멤버의 전화번호: 체크아웃 시 수집(또는 인증)된 가장 최근 번호이며, 없으면 멤버가 이 판매자와 공유한 계정 번호입니다. 계정에 `member:phone:read` 권한이 없거나 둘 다 없는 경우 `null`입니다.

**status** `string` *required*

멤버가 계정에 속해 있는 동안 `joined`, 탈퇴한 후 `left`입니다.

사용 가능한 옵션: `joined`, `left`

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

토큰 거래로부터 계산된 이 계정에 대한 멤버의 현재 토큰 잔액입니다.

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

멤버가 계정의 마케팅 커뮤니케이션 수신을 거부하면 `unsubscribed`, 구독 중인 동안 `null`입니다. 멤버만 변경할 수 있습니다.

사용 가능한 옵션: `unsubscribed`

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

멤버가 계정의 상품에 지출한 금액(USD)입니다.

> [accordion] 속성
>
> **amount** `string` *required*
>
> 주 단위 금액으로, 정확한 소수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
>
> **currency** `string` *required*
>
> 소문자로 된 세 자리 ISO 4217 통화 코드입니다.
>
> **decimals** `integer` *required*
>
> 금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
>
> **display\_decimals** `integer` *required*
>
> 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만 의도적으로 항상 같지는 않습니다: COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.

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

이 멤버의 실제 사용자입니다. 구매자가 개인이 아닌 다른 비즈니스인 경우 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 사용자 ID이며, 접두사는 `user_`입니다.
>
> **city** `string | null` *required*
>
> IP 주소에서 파생된 사용자의 도시입니다. 알 수 없거나 사용자가 위치 공유를 끈 경우 `null`입니다.
>
> **country** `string | null` *required*
>
> IP 주소에서 파생된 사용자의 국가로, `US`와 같은 ISO 3166-1 alpha-2 코드입니다. 알 수 없거나 사용자가 위치 공유를 끈 경우 `null`입니다.
>
> **name** `string | null` *required*
>
> 표시 이름입니다.
>
> **profile\_picture** `object` *required*
>
> 아바타 래퍼입니다. `url`은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 자리 표시자입니다.
>
> > [accordion] 속성
> >
> > **url** `string` *required*
> >
> > 아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 자리 표시자입니다.
>
> **state** `string | null` *required*
>
> IP 주소에서 파생된 사용자의 주 또는 지역 코드로, `CA` 등이 있습니다. 알 수 없거나 사용자가 위치 공유를 끈 경우 `null`입니다.
>
> **username** `string` *required*
>
> 공개 사용자 이름입니다.

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

- [Channel Members API](https://docs.whop.com/ko/api-reference/channel-members/channel-member.md)
- [Team Members API](https://docs.whop.com/ko/api-reference/team-members/team-member.md)
- [Member](https://docs.whop.com/ko/api-reference/legacy/members/member.md)
