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
A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************
Headers
Pins the request to a dated API version.
"2026-07-23"
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.
Filter by billing state. canceling matches active memberships set to cancel at period end; paused matches memberships with payment collection paused.
active, trialing, past_due, completed, canceled, expired, canceling, paused Filter to memberships of this product (prod_ tag). Repeat as product_ids[] for several.
Filter to memberships of this plan (plan_ tag). Repeat as plan_ids[] for 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 memberships to return from the start of the window.
x <= 100Cursor to paginate forwards from.
Number of memberships to return from the end of the window.
x <= 100Cursor to paginate backwards from.

