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

# List your organisation's members

> Every seated person in the organisation, oldest seat first. An active session or an API key with member.read is required.

Members seated in your organisation are listed in chronological order, oldest seat first. Every caller with `member.read` permission can view this list. API keys and widget embeds are machine principals and do not appear in this listing.

The returned records reflect human users with an assigned role in the authenticated organisation.

<ParamField query="limit" type="integer" default="100">
  How many members to return per page, from 1 to 100. Requests outside this range receive `400 Bad
      Request`.
</ParamField>

## Response

<ResponseField name="data" type="object[]" required>
  The organisation members.

  <Expandable title="properties">
    <ResponseField name="id" type="string" required>
      The member's account identifier (UUID).
    </ResponseField>

    <ResponseField name="name" type="string" required>
      The display name of the member.
    </ResponseField>

    <ResponseField name="email" type="string" required>
      The registered email address.
    </ResponseField>

    <ResponseField name="role" type="string" required>
      Assigned permission role: `owner`, `admin`, `editor`, `normal`, or `dataset_operator`.
    </ResponseField>

    <ResponseField name="status" type="string" required>
      Account status: `active`, `suspended`, or `pending`.
    </ResponseField>

    <ResponseField name="created_at" type="string" required>
      When the user was first registered, ISO 8601 in UTC.
    </ResponseField>

    <ResponseField name="last_active_at" type="string | null" required>
      Timestamp of most recent activity, or `null`.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl "https://app.mithunai.com/arukz/api/v1/members?limit=50" \
    -H "Authorization: Bearer mth_live_..."
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  from mithunai import MithunClient

  client = MithunClient(api_key="mth_live_...")
  members = client.members.list(limit=50)
  print(members)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "data": [
      {
        "id": "usr_998124a",
        "name": "Alex Mercer",
        "email": "alex@enterprise.com",
        "role": "owner",
        "status": "active",
        "created_at": "2026-01-10T12:00:00Z",
        "last_active_at": "2026-09-27T04:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>