Skip to main content
GET
/
memberships
JavaScript
import Whop from '@whop/sdk';

const client = new Whop({
  apiKey: process.env['WHOP_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const membershipListResponse of client.memberships.list()) {
  console.log(membershipListResponse.id);
}
{
  "data": [
    {
      "id": "mem_xxxxxxxxxxxxxx",
      "status": "trialing",
      "created_at": "2023-12-01T05:00:00.401Z",
      "updated_at": "2023-12-01T05:00:00.401Z",
      "manage_url": "<string>",
      "member": {
        "id": "mber_xxxxxxxxxxxxx"
      },
      "user": {
        "id": "user_xxxxxxxxxxxxx",
        "username": "johndoe42",
        "name": "John Doe"
      },
      "renewal_period_start": "2023-12-01T05:00:00.401Z",
      "renewal_period_end": "2023-12-01T05:00:00.401Z",
      "cancel_at_period_end": true,
      "cancellation_reason": "<string>",
      "canceled_at": "2023-12-01T05:00:00.401Z",
      "currency": "usd",
      "company": {
        "id": "biz_xxxxxxxxxxxxxx",
        "title": "<string>"
      },
      "plan": {
        "id": "plan_xxxxxxxxxxxxx"
      },
      "promo_code": {
        "id": "promo_xxxxxxxxxxxx"
      },
      "product": {
        "id": "prod_xxxxxxxxxxxxx",
        "title": "<string>"
      },
      "license_key": "<string>",
      "metadata": {},
      "payment_collection_paused": true
    }
  ],
  "page_info": {
    "end_cursor": "<string>",
    "start_cursor": "<string>",
    "has_next_page": true,
    "has_previous_page": true
  }
}

Authorizations

​
Authorization
string
header
required

The app API key from an app from the /dashboard/developer page

Query Parameters

​
after
string | null

Returns the elements in the list that come after the specified cursor.

​
before
string | null

Returns the elements in the list that come before the specified cursor.

​
first
integer | null

Returns the first n elements from the list.

Example:

42

​
last
integer | null

Returns the last n elements from the list.

Example:

42

​
company_id
string | null

The ID of the company to list memberships for

Example:

"biz_xxxxxxxxxxxxxx"

​
direction
enum<string> | null

The direction to sort the memberships by

Available options:
asc,
desc
​
order
enum<string> | null

The order to sort the memberships by

Available options:
id,
created_at,
status,
canceled_at,
date_joined,
total_spend
​
product_ids
string[] | null

The product IDs to filter the memberships by

Represents a unique identifier that is Base64 obfuscated. It is often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "VXNlci0xMA==") or integer (such as 4) input value will be accepted as an ID.

​
statuses
enum<string>[] | null

The membership status to filter the memberships by

The status of a membership

Available options:
trialing,
active,
past_due,
completed,
canceled,
expired,
unresolved,
drafted
​
cancel_options
enum<string>[] | null

The cancel options to filter the memberships by

The different reasons a user can choose for why they are canceling their membership.

Available options:
too_expensive,
switching,
missing_features,
technical_issues,
bad_experience,
other,
testing
​
plan_ids
string[] | null

The plan IDs to filter the memberships by

Represents a unique identifier that is Base64 obfuscated. It is often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "VXNlci0xMA==") or integer (such as 4) input value will be accepted as an ID.

​
user_ids
string[] | null

Only return memberships from these whop user ids

Represents a unique identifier that is Base64 obfuscated. It is often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "VXNlci0xMA==") or integer (such as 4) input value will be accepted as an ID.

​
promo_code_ids
string[] | null

The promo code IDs to filter the memberships by

Represents a unique identifier that is Base64 obfuscated. It is often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "VXNlci0xMA==") or integer (such as 4) input value will be accepted as an ID.

​
created_before
string<date-time> | null

The maximum creation date to filter by

Example:

"2023-12-01T05:00:00.401Z"

​
created_after
string<date-time> | null

The minimum creation date to filter by

Example:

"2023-12-01T05:00:00.401Z"

Response

A successful response

The connection type for PublicMembership.

​
data
object[]
required

A list of nodes.

​
page_info
object
required

Information to aid in pagination.