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

> Üye (Member), bir alıcının bir hesapla olan ilişkisidir: kaç üyeliğe sahip olursa olsun, her müşteri için bir kayıt.

Katılıp katılmadığını veya ayrılıp ayrılmadığını, erişim düzeyini ve hesabın içeriğini en son ne zaman açtığını takip eder.

Bir hesabın üyelerini listelemek ve aramak, tek bir üyeyi almak ve bir üyenin etkinlik günlüğünü okumak için Members API'sini kullanın. Üye satırları üyelik yaşam döngüsü tarafından oluşturulur ve sürdürülür; erişim vermek veya iptal etmek için bunun yerine üyeliklerle çalışın.

> [!NOTE]
>
> Legacy [Members](https://docs.whop.com/tr/api-reference/members/member) kaynağının yerini alır. Mevcut Legacy entegrasyonları çalışmaya devam eder; kararlılık sözleşmesi için [API sürümleri](https://docs.whop.com/tr/developer/api/versioning.md) sayfasına bakın.

## Uç noktalar

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

## Öznitelikler

**id** `string` *required*

`mber_` önekli üye kimliği.

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

Üyenin hesapta neye erişebildiği: ödeme yapan üyeler için `customer`, ekip üyeleri için `admin`, tüm erişim izinlerinin süresi dolduğunda `no_access`.

Kullanılabilir seçenekler: `no_access`, `admin`, `customer`

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

Bu üyenin ait olduğu `biz_` önekli hesap.

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

Üye kaydının oluşturulduğu zaman, ISO 8601 zaman damgası olarak.

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

Bu üye için gösterilecek ad: kullanıcının adı veya ad belirlememişse kullanıcı adı. `user` değeri `null` olduğunda satın alan işletmenin adı.

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

Kullanıcının Whop genelindeki USD cinsinden brüt geliri, düzenli aralıklarla yenilenir. Kullanıcı kazançlarını gizlediğinde veya alıcı başka bir işletme olduğunda `null` olur.

> [accordion] Properties
>
> **last\_24\_hours** `string` *required*
>
> Son 24 saatteki USD cinsinden brüt gelir.
>
> **last\_30\_days** `string` *required*
>
> Son 30 gündeki USD cinsinden brüt gelir.
>
> **last\_7\_days** `string` *required*
>
> Son 7 gündeki USD cinsinden brüt gelir.
>
> **lifetime** `string` *required*
>
> Tüm zamanların USD cinsinden brüt geliri.

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

Kullanıcının e-posta adresi. Hesapta `member:email:read` izni olmadan, alıcı başka bir işletme olduğunda veya kullanıcının atanmış bir e-postası olmadığında `null` olur.

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

Üyenin hesaba ilk katıldığı zaman, ISO 8601 zaman damgası olarak.

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

Üyenin hesabın içeriğini en son açtığı zaman, ISO 8601 zaman damgası olarak. Hiç açmadıysa `null` olur.

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

`last_activity_at` zamanında ne olduğu. `object`, bunun hangi tür etkinlik olduğunu belirtir. Hesapta `support_chat:read` izni olmadan veya `last_activity_at` değeri `null` olduğunda `null` olur.

> [accordion] Properties
>
> **id** `string` *required*
>
> Mesaj kimliği.
>
> **author** `object | null` *required*
>
> Mesajı kimin gönderdiği: üye veya hesabın ekibinden biri. Gönderenin hesabı artık mevcut değilse `null` olur.
>
> > [accordion] Properties
> >
> > **id** `string` *required*
> >
> > `user_` önekli kullanıcı kimliği.
> >
> > **name** `string | null` *required*
> >
> > Görünen ad.
> >
> > **profile\_picture** `object` *required*
> >
> > Avatar sarmalayıcısı. `url` alanı her zaman bulunur ve kullanıcı bir resim belirlemediğinde otomatik oluşturulan bir yer tutucudur.
> >
> > > [accordion] Properties
> > >
> > > **url** `string` *required*
> > >
> > > Avatar görseli URL'si. Her zaman bulunur. Kullanıcı bir resim belirlemediğinde otomatik oluşturulan bir yer tutucudur.
> >
> > **username** `string` *required*
> >
> > Herkese açık kullanıcı adı.
>
> **channel\_id** `string` *required*
>
> Mesajın gönderildiği destek sohbeti.
>
> **created\_at** `string` *required*
>
> Mesajın gönderildiği zaman, ISO 8601 zaman damgası olarak.
>
> **object** `string` *required*
>
> Her zaman `message`.
>
> **plain\_content** `string | null` *required*
>
> Biçimlendirme olmadan mesaj metni. Mesajda metin olmadığında (ör. tek başına bir ek) `null` olur.

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

Üye ile hesabın en son etkileşime geçtiği zaman, ISO 8601 zaman damgası olarak. Örneğin, üyenin destek sohbetindeki bir mesaj.

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

Bu üye üzerinde saklanan kendi anahtar-değer verileriniz. Hiçbiri ayarlanmamışsa `null` olur.

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

Üyenin hesaptaki üyeliklerinden türetilen en son yaşam döngüsü durumu; örneğin `paid_subscriber`, `canceling` veya `churned`. İlk kez hesaplanana kadar `null` olur.

Kullanılabilir seçenekler: `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` değerinin geçerli olduğu zaman, ISO 8601 zaman damgası olarak. `most_recent_action` değeri `null` olduğunda `null` olur.

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

Hesabın `PATCH /members/:id` ile bu müşteriye verdiği ad. Faturalar, bu üyeye ait her faturada kullanıcının kendi adı yerine bunu müşteri adı olarak gösterir. Hesap bir ad belirlemediyse `null` olur.

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

Üyenin telefon numarası: ödeme sırasında toplanan (veya doğrulanan) en son numara, aksi halde bu satıcıyla paylaştıysa hesap numarası. Hesapta `member:phone:read` izni olmadan veya hiçbiri yoksa `null` olur.

**status** `string` *required*

Üye hesabın bir parçasıyken `joined`, ayrıldıktan sonra `left`.

Kullanılabilir seçenekler: `joined`, `left`

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

Üyenin bu hesap için, token işlemlerinden hesaplanan mevcut token bakiyesi.

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

Üye hesabın pazarlama iletişimlerinden çıktığında `unsubscribed`, abone olduğu sürece `null` olur. Yalnızca üye bunu değiştirebilir.

Kullanılabilir seçenekler: `unsubscribed`

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

Üyenin hesabın ürünlerine USD cinsinden ne kadar harcadığı.

> [accordion] Properties
>
> **amount** `string` *required*
>
> Ana birim cinsinden, tam ondalık dize olarak tutar. Örneğin `"10.00"` on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için dize olarak verilir.
>
> **currency** `string` *required*
>
> Küçük harfli, üç harfli ISO 4217 para birimi kodu.
>
> **decimals** `integer` *required*
>
> Tutarın kaç ondalık basamak taşıdığı. Bu, tahsilatın kendisinin çalıştığı hassasiyettir.
>
> **display\_decimals** `integer` *required*
>
> Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle `decimals` değerine eşittir, ancak bilinçli olarak her zaman değil: COP sentavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu yüzden değerler `2` ve `0` olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.

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

Bu üyenin arkasındaki kullanıcı. Alıcı bir kişi yerine başka bir işletme olduğunda `null` olur.

> [accordion] Properties
>
> **id** `string` *required*
>
> `user_` önekli kullanıcı kimliği.
>
> **city** `string | null` *required*
>
> Kullanıcının IP adresinden türetilen şehri. Bilinmiyorsa veya kullanıcı konum paylaşımını kapattıysa `null` olur.
>
> **country** `string | null` *required*
>
> Kullanıcının IP adresinden türetilen, `US` gibi ISO 3166-1 alpha-2 kodu biçimindeki ülkesi. Bilinmiyorsa veya kullanıcı konum paylaşımını kapattıysa `null` olur.
>
> **name** `string | null` *required*
>
> Görünen ad.
>
> **profile\_picture** `object` *required*
>
> Avatar sarmalayıcısı. `url` alanı her zaman bulunur ve kullanıcı bir resim belirlemediğinde otomatik oluşturulan bir yer tutucudur.
>
> > [accordion] Properties
> >
> > **url** `string` *required*
> >
> > Avatar görseli URL'si. Her zaman bulunur. Kullanıcı bir resim belirlemediğinde otomatik oluşturulan bir yer tutucudur.
>
> **state** `string | null` *required*
>
> Kullanıcının IP adresinden türetilen, `CA` gibi eyalet veya bölge kodu. Bilinmiyorsa veya kullanıcı konum paylaşımını kapattıysa `null` olur.
>
> **username** `string` *required*
>
> Herkese açık kullanıcı adı.

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

- [Permissions API](https://docs.whop.com/tr/api-reference/permissions/permission.md)
- [List members](https://docs.whop.com/tr/api-reference/legacy/members/list-members.md)
- [Retrieve member](https://docs.whop.com/tr/api-reference/legacy/members/retrieve-member.md)
