---
title: "List Organization Members"
method: POST
path: "/api/v2/organizations/listMembers"
tags: ["Organizations"]
---

# List Organization Members

`POST /api/v2/organizations/listMembers`

## Request

- Base URL: `https://zeropath.com`
- URL: `https://zeropath.com/api/v2/organizations/listMembers`
- Auth: API key in header `X-ZeroPath-API-Token-Id` and API key in header `X-ZeroPath-API-Token-Secret`

Requires MEMBER_VIEW permission. List all members of the organization with their roles (ADMIN, MEMBER, VIEWER) and active status. Use this to find who has access to the platform, check team composition, or identify users for assignment.

## Request body

- OrganizationsListMembersRequest: Input for listing organization members
  - `organizationId` string: Organization ID to list members for. If omitted, the organization is resolved from the authenticated user.

## Response `200`

Organization members retrieved successfully

- OrganizationsListMembersResponse: Response containing organization members with their roles and status
  - `members` object[], required: List of organization members with their roles and active status
    - `userId` string, required: Unique identifier of the user
    - `firstName` string: First name of the member
    - `lastName` string: Last name of the member
    - `email` string, email, required: Email address of the member
    - `role` 'ADMIN' | 'MEMBER' | 'VIEWER', required: Role of the member in the organization. ADMIN has full access, MEMBER has standard access, VIEWER has read-only access.
    - `active` boolean, required: Whether the member is currently active in the organization

## Other responses

- `401`: Error Response
- `403`: Error Response

---

[API](https://skmtc.dev/zeropath/apis/zeropath-api.md) - [All operations](https://skmtc.dev/zeropath/apis/zeropath-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zeropath/apis/zeropath-api/revisions/126e9c80ba0d?raw)