List Memberships
Lists every membership the caller can read: an account API key its account’s; a user credential their own plus those of every account they manage. account_id and user_id only narrow that list — values outside the caller’s reach return fewer results, not an error.
Authorizations
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
Pins the request to a dated API version.
"2026-10-13"
Query Parameters
Narrow to one account (biz_ tag). With read access to the account this lists all of its memberships; without, only the caller's own memberships in it.
Narrow to one user's memberships (user_ tag, or me for the caller). A user outside the caller's visible set returns an empty list.
Narrow to one member's memberships (mber_ tag), including memberships bought by another business. A member outside the caller's visible set returns an empty list.
Filter by billing state. trialing, active, past_due, completed, canceled, and expired match the membership's status; active, trialing, and past_due exclude memberships set to cancel at period end. The other values are derived buckets that never appear as a status: canceling matches memberships set to cancel at period end; paused matches memberships with payment collection paused; expiring matches one-time purchases that have not yet expired; one_time matches one-time purchases that never expire; unclaimed matches memberships with no buyer user, including memberships bought by another business; banned matches memberships whose buyer is banned from the account.
active, trialing, past_due, completed, canceled, expired, canceling, paused, expiring, one_time, unclaimed, banned Filter to memberships matching any of these billing states, with the same meanings as status. Repeat the parameter to pass several. Combined with status when both are sent.
active, trialing, past_due, completed, canceled, expired, canceling, paused, expiring, one_time, unclaimed, banned Filter to memberships of this product (prod_ tag).
Filter to memberships of any of these products, each prefixed prod_. Repeat the parameter to pass several.
Filter to memberships of this variant (plan_ tag).
Filter to memberships of any of these variants, each prefixed plan_. Repeat the parameter to pass several.
Filter to memberships discounted by any of these promo codes, each prefixed promo_. Repeat the parameter to pass several.
Only memberships created after this ISO 8601 timestamp.
Only memberships created before this ISO 8601 timestamp.
Sort field.
created_at Sort direction.
asc, desc Number of results to return from the start of the range.
x <= 100Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.
Number of results to return from the end of the range.
x <= 100Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

