Retrieve Member - Whop Docs

TypeScript

import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: "YOUR_TOKEN", apiVersionDate: "2026-08-21-1", idempotencyKey: "YOUR_IDEMPOTENCY_KEY" });
await client.members.retrieve({
    id: "id"
});

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.whop.com/api/v1/members/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/members/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.whop.com/api/v1/members/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/members/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "access_level": "customer",
  "account_id": "biz_xxxxxxxxxxxxxx",
  "created_at": "2026-01-01T12:00:00.000Z",
  "display_name": "Dana Whitfield",
  "email": "marcus@shinetime.example",
  "id": "mber_xxxxxxxxxxxxxx",
  "joined_at": "2026-01-01T12:00:00.000Z",
  "last_accessed_at": "2026-01-01T12:00:00.000Z",
  "most_recent_action": "paid_subscriber",
  "most_recent_action_at": "2026-01-01T12:00:00.000Z",
  "phone_number": "+xxxxxxxxxxx",
  "status": "joined",
  "token_balance": 70.25,
  "usd_total_spent": {
    "amount": "-1234.56",
    "currency": "usd",
    "decimals": 2,
    "display_decimals": 2
  },
  "user": {
    "id": "user_xxxxxxxxxxxxxx",
    "name": "Dana Whitfield",
    "profile_picture": {
      "url": "https://ui-avatars.com/api/"
    },
    "username": "danawhitfield"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

GET

members

{id}

TypeScript

import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: "YOUR_TOKEN", apiVersionDate: "2026-08-21-1", idempotencyKey: "YOUR_IDEMPOTENCY_KEY" });
await client.members.retrieve({
    id: "id"
});

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.whop.com/api/v1/members/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/members/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.whop.com/api/v1/members/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/members/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "access_level": "customer",
  "account_id": "biz_xxxxxxxxxxxxxx",
  "created_at": "2026-01-01T12:00:00.000Z",
  "display_name": "Dana Whitfield",
  "email": "marcus@shinetime.example",
  "id": "mber_xxxxxxxxxxxxxx",
  "joined_at": "2026-01-01T12:00:00.000Z",
  "last_accessed_at": "2026-01-01T12:00:00.000Z",
  "most_recent_action": "paid_subscriber",
  "most_recent_action_at": "2026-01-01T12:00:00.000Z",
  "phone_number": "+xxxxxxxxxxx",
  "status": "joined",
  "token_balance": 70.25,
  "usd_total_spent": {
    "amount": "-1234.56",
    "currency": "usd",
    "decimals": 2,
    "display_decimals": 2
  },
  "user": {
    "id": "user_xxxxxxxxxxxxxx",
    "name": "Dana Whitfield",
    "profile_picture": {
      "url": "https://ui-avatars.com/api/"
    },
    "username": "danawhitfield"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

Authorizations

Authorization

string

header

required

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Headers

Api-Version-Date

string

Pins the request to a dated API version.

Example:

"2026-10-13"

Path Parameters

string

required

Member ID (mber_ tag).

Response

the stamped number outranks the consented account read

access_level

enum<string>

required

What the member can reach on the account: customer for paying members, admin for team members, no_access once every grant has lapsed.

Available options:

no_access,

admin,

customer

Example:

"customer"

account_id

string

required

The account this member belongs to, prefixed biz_.

Example:

"biz_xxxxxxxxxxxxxx"

created_at

string

required

When the member record was created, as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

display_name

string

required

The name to show for this member: the user's name, or their username when they have not set one. The buying business's name when user is null.

Example:

"Dana Whitfield"

string | null

required

The user's email address. null without member:email:read on the account, when the buyer is another business, or when the user has no assigned email.

Example:

"marcus@shinetime.example"

string

required

Member ID, prefixed mber_.

Example:

"mber_xxxxxxxxxxxxxx"

joined_at

string

required

When the member first joined the account, as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

last_accessed_at

string | null

required

When the member last opened the account's content, as an ISO 8601 timestamp. null if they never have.

Example:

"2026-01-01T12:00:00.000Z"

most_recent_action

enum<string> | null

required

The member's latest lifecycle state on the account, derived from their memberships, such as paid_subscriber, canceling, or churned. null until it is first computed.

Available options:

canceling,

churned,

finished_split_pay,

paused,

paid_subscriber,

paid_once,

expiring,

joined,

left,

trialing,

pending_entry,

renewing,

past_due,

null

Example:

"paid_subscriber"

most_recent_action_at

string | null

required

When most_recent_action took effect, as an ISO 8601 timestamp. null when most_recent_action is null.

Example:

"2026-01-01T12:00:00.000Z"

phone_number

string | null

required

The member's phone number, or null. Their account number when they have shared one with this seller; otherwise the most recent number collected (or verified) at checkout.

Example:

"+xxxxxxxxxxx"

status

enum<string>

required

joined while the member is part of the account, left after they leave.

Available options:

joined,

left

Example:

"joined"

token_balance

number

required

The member's current token balance for this account, computed from token transactions.

Example:

70.25

usd_total_spent

object

required

How much the member has spent on the account's products, in USD.

Show child attributes

user

object | null

required

The user behind this member. null when the buyer is another business rather than a person.

Show child attributes