TypeScript

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

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

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

fetch('https://api.whop.com/api/v1/team_members', 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/team_members",
  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/team_members"

	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/team_members")

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

{
  "data": [
    {
      "account_id": "biz_xxxxxxxxxxxxxx",
      "authorized_role": {
        "id": "aurl_xxxxxxxxxxxxxx",
        "name": "community-moderators"
      },
      "created_at": "2026-01-01T12:00:00.000Z",
      "direct_reports_count": 0,
      "email": "marcus@shinetime.example",
      "id": "ausr_xxxxxxxxxxxxxx",
      "is_agent": false,
      "reports_to_chain": [
        {
          "id": "ausr_xxxxxxxxxxxxxx",
          "user": {
            "id": "user_xxxxxxxxxxxxxx",
            "name": "Dana Whitfield",
            "profile_picture": {
              "url": "https://ui-avatars.com/api/"
            },
            "username": "danawhitfield"
          }
        }
      ],
      "reports_to_id": "ausr_xxxxxxxxxxxxxx",
      "role": "admin",
      "status": "joined",
      "updated_at": "2026-01-01T12:00:00.000Z",
      "user": {
        "id": "user_xxxxxxxxxxxxxx",
        "name": "Dana Whitfield",
        "profile_picture": {
          "url": "https://ui-avatars.com/api/"
        },
        "username": "danawhitfield"
      }
    }
  ],
  "page_info": {
    "end_cursor": null,
    "has_next_page": false,
    "has_previous_page": false,
    "start_cursor": "a:WyJjdXJzb3IiLDFd"
  }
}

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

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

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

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

Team Members

List Team Members

Lists an account’s team members, including pending invites. A user credential with company:basic:read may list only its own joined membership by passing its own user_id and status=joined. Listing role=workforce is also allowed with the bounty:create scope. A signed-in Partner, or a member others report to, without company:authorized_user:read lists only their own joined membership and the members who report up to them, never pending invites. Members with the view-only Partner role are listed after all other members.

GET

team_members

TypeScript

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

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

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

fetch('https://api.whop.com/api/v1/team_members', 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/team_members",
  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/team_members"

	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/team_members")

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

{
  "data": [
    {
      "account_id": "biz_xxxxxxxxxxxxxx",
      "authorized_role": {
        "id": "aurl_xxxxxxxxxxxxxx",
        "name": "community-moderators"
      },
      "created_at": "2026-01-01T12:00:00.000Z",
      "direct_reports_count": 0,
      "email": "marcus@shinetime.example",
      "id": "ausr_xxxxxxxxxxxxxx",
      "is_agent": false,
      "reports_to_chain": [
        {
          "id": "ausr_xxxxxxxxxxxxxx",
          "user": {
            "id": "user_xxxxxxxxxxxxxx",
            "name": "Dana Whitfield",
            "profile_picture": {
              "url": "https://ui-avatars.com/api/"
            },
            "username": "danawhitfield"
          }
        }
      ],
      "reports_to_id": "ausr_xxxxxxxxxxxxxx",
      "role": "admin",
      "status": "joined",
      "updated_at": "2026-01-01T12:00:00.000Z",
      "user": {
        "id": "user_xxxxxxxxxxxxxx",
        "name": "Dana Whitfield",
        "profile_picture": {
          "url": "https://ui-avatars.com/api/"
        },
        "username": "danawhitfield"
      }
    }
  ],
  "page_info": {
    "end_cursor": null,
    "has_next_page": false,
    "has_previous_page": false,
    "start_cursor": "a:WyJjdXJzb3IiLDFd"
  }
}

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

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

{
  "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-11-04-1"

Query Parameters

account_id

string

required

Account ID, prefixed biz_. A global admin query passes global to list the joined members of every partner account, in created_at order; of the reporting line filters, only team_lead_id and has_referred_businesses apply.

status

enum<string>

Only return members with this status: joined (accepted members) or pending (pending invites). Both are returned by default.

Available options:

joined,

pending

user_id

string

Only return the membership for this user ID, prefixed user_.

role

enum<string>

Only return members with this role. custom matches members on a dashboard-managed custom role.

Available options:

owner,

admin,

partner,

sales_manager,

moderator,

advertiser,

app_manager,

support,

manager,

workforce,

custom

query

string

Only return members whose name or username contains this text, and invites whose email contains it.

reports_to_id

string

Only return the direct reports of this team member, whose ID may start with ausr_ or mber_. Pass the account ID, prefixed biz_, for the members who report to the business directly. Pending invites are excluded, and the list pages in created_at order without moving Partner-role members last.

direct_reports_min

integer

Only return members with at least this many direct reports. Pending invites are excluded, and the list pages in created_at order without moving Partner-role members last.

Required range: x >= 0

direct_reports_max

integer

Only return members with at most this many direct reports; 0 returns the people who manage no one. Pending invites are excluded, and the list pages in created_at order without moving Partner-role members last.

Required range: x >= 0

team_lead_id

string

Only return this user, prefixed user_, and everyone under them in today's org chart: the same team the stats API's team_lead_id reads. With account_id=global, their line in every partner account where they hold a role. Pending invites are excluded, and the list pages in created_at order without moving Partner-role members last.

has_referred_businesses

boolean

When true, only members who referred at least one business for their account, the reps the partner_reps stats metric counts; when false, only members who referred none. Pending invites are excluded, and the list pages in created_at order without moving Partner-role members last.

created_before

string

Only return members added before this ISO 8601 timestamp.

created_after

string

Only return members added after this ISO 8601 timestamp.

order

enum<string>

default:created_at

Field used to sort members. Members with the view-only Partner role are listed after all other members whichever way the list is sorted.

Available options:

created_at

direction

enum<string>

default:desc

Sort direction. Defaults to desc.

Available options:

asc,

desc

first

integer

default:20

Number of results to return from the start of the range.

Required range: x <= 100

after

string

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

last

integer

Number of results to return from the end of the range.

Required range: x <= 100

before

string

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

Response

Team members listed.

data

object[]

required

Show child attributes

page_info

object

required

Show child attributes

Introduction

Reference

Core Resources

Payments

Money

Commerce

Websites

Ads

Analytics

Communication

Partners

Workforce

Media

Developer

List Team Members

Authorizations

Headers

Query Parameters

Response