> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getbutter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Members

Retrieve a list of all members within your organization.

### Request

<ParamField header="X-Organization-Id" type="string" required>
  The unique identifier of the organization.
</ParamField>

### Response

<ResponseField name="members" type="array">
  List of member objects belonging to the organization.

  <Expandable title="Member Object">
    <ResponseField name="membership_id" type="string">
      The unique identifier for the membership.
    </ResponseField>

    <ResponseField name="user_id" type="string">
      The unique identifier of the user.
    </ResponseField>

    <ResponseField name="email" type="string">
      The email address of the user.
    </ResponseField>

    <ResponseField name="name" type="string">
      The full name of the user.
    </ResponseField>

    <ResponseField name="role" type="string">
      The role of the member (e.g., `admin`, `agent_manager`, `user`).
    </ResponseField>

    <ResponseField name="status" type="string">
      The current status of the membership (e.g., `active`).
    </ResponseField>

    <ResponseField name="joined_at" type="string">
      The timestamp when the user joined the organization.
    </ResponseField>

    <ResponseField name="last_login" type="string">
      The timestamp of the user's last login.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "members": [
      {
        "membership_id": "mem_abc123",
        "user_id": "user_def456",
        "email": "user@example.com",
        "name": "John Doe",
        "role": "admin",
        "status": "active",
        "joined_at": "2024-01-01T12:00:00Z",
        "last_login": "2024-03-01T08:30:00Z"
      }
    ]
  }
  ```
</ResponseExample>