---
title: "List members"
method: GET
path: "/open-api/v1.0/memberships/members"
tags: ["BETA: Memberships"]
---

# List members

`GET /open-api/v1.0/memberships/members`

## Request

- Base URL: `https://api.fourthwall.com`
- URL: `https://api.fourthwall.com/open-api/v1.0/memberships/members`
- Auth: one of:
  - OAuth 2
    - Implicit: `https://auth.staging.fourthwall.com/auth/realms/Fourthwall/protocol/openid-connect/auth`
    - Scopes: `memberships_read`
  - HTTP basic

*Rate limit: 100 requests / 10 seconds per shop. See [Rate limiting](/guides/rate-limiting).*

Lists all members for the current shop. The maximum page size is 100 - larger values are capped at 100.

## Query parameters

- `page` integer
- `size` integer

## Response `200`

OK

- ComFourthwallOpenapiModelOpenApiPageResponseComFourthwallOpenapiModelMembershipSupporterV1
  - `results` ComFourthwallOpenapiModelMembershipSupporterV1[], required
    - `id` string, required
    - `email` string, required
    - `nickname` string, required
    - `createdAt` string, date-time, required
    - `subscription` union, required
      - ComFourthwallOpenapiModelMembershipSupporterV1SubscriptionActive
        - `type` 'ACTIVE', required
        - `variant` ComFourthwallOpenapiModelMembershipTierVariantV1, required
          - `id` string, required
          - `tierId` string, required
          - `interval` 'ANNUAL' | 'MONTHLY', required
          - `amount` Money, required
            - `value` number, required
            - `currency` string, required
          - `offerId` string
      - ComFourthwallOpenapiModelMembershipSupporterV1SubscriptionCancelled
        - `type` 'CANCELLED', required
        - `variant` ComFourthwallOpenapiModelMembershipTierVariantV1, required
          - `id` string, required
          - `tierId` string, required
          - `interval` 'ANNUAL' | 'MONTHLY', required
          - `amount` Money, required
            - `value` number, required
            - `currency` string, required
          - `offerId` string
      - ComFourthwallOpenapiModelMembershipSupporterV1SubscriptionNone
        - `type` 'NONE', required
      - ComFourthwallOpenapiModelMembershipSupporterV1SubscriptionSuspended
        - `type` 'SUSPENDED', required
        - `variant` ComFourthwallOpenapiModelMembershipTierVariantV1, required
          - `id` string, required
          - `tierId` string, required
          - `interval` 'ANNUAL' | 'MONTHLY', required
          - `amount` Money, required
            - `value` number, required
            - `currency` string, required
          - `offerId` string
  - `total` integer
  - `page` integer
  - `size` integer
  - `totalPages` integer

## Other responses

- `429`: Rate limited: 100 requests / 10 seconds per shop.

## Changes

- **2026-07-21** `d02dd5a76313`: 1 info
  - added the non-success response with the status `429`

[Operation history](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2/changes/open-api/v1.0/memberships/members/get.md)

---

[API](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2.md) - [All operations](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2/llms.txt) - [OpenAPI document](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2/revisions/77de1061d5c9?raw)