Skip to main content
GET
TypeScript

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"

Query Parameters

account_id
string

The account to list members for (biz_ tag). Defaults to the account the credential acts as.

access_level
enum<string>

Filter by what the member can reach on the account.

Available options:
no_access,
admin,
customer
status
enum<string>

Filter by whether the member is still part of the account.

Available options:
joined,
left
user_ids
string[]

Only return members whose users match these user_ identifiers.

most_recent_actions
enum<string>[]

Only return members whose most_recent_action is one of these values.

Available options:
canceling,
churned,
finished_split_pay,
paused,
paid_subscriber,
paid_once,
expiring,
joined,
left,
trialing,
pending_entry,
renewing,
past_due
membership_status
enum<string>

active returns members holding at least one membership that currently grants access; inactive returns members holding at least one membership that does not. Combined with product_ids, plan_ids, or promo_code_ids, one membership must match all of them.

Available options:
active,
inactive
product_ids
string[]

Only return members holding a membership to one of these products, prefixed prod_. Unknown IDs match nothing.

plan_ids
string[]

Only return members holding a membership on one of these plans, prefixed plan_. Unknown IDs match nothing.

promo_code_ids
string[]

Only return members holding a membership bought with one of these promo codes, prefixed promo_. Unknown IDs match nothing.

query
string

Search members by name or username. An exact email address also matches when the credential holds the member:email:read scope.

created_after
string

Only members who joined after this ISO 8601 timestamp.

created_before
string

Only members who joined before this ISO 8601 timestamp.

order
enum<string>
default:created_at

Sort field. most_recent_action_at places members without one first when ascending and last when descending.

Available options:
created_at,
joined_at,
last_accessed_at,
most_recent_action_at,
usd_total_spent
direction
enum<string>
default:desc

Sort direction.

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

members listed

data
object[]
required
page_info
object
required