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

# Search the members of an organization

> Returns a paginated list of the members of the caller organization, optionally filtered by role and active status, alongside the total count of active admins (used to guard "last admin" actions across pages). The organization is resolved from the authenticated context, not from the request body. Read-only — any active member (not just admins) may call it. Requires a Nevermined API key.



## OpenAPI

````yaml /api-reference/organizations-openapi.json post /organizations/members
openapi: 3.0.0
info:
  title: Nevermined Organizations API
  description: >-
    Manage a Nevermined organization programmatically — members, tiers, groups &
    budgets, treasury wallets, customers, webhooks, analytics, and
    agent-discovery surfaces.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.sandbox.nevermined.app/api/v1
    description: Sandbox
  - url: https://api.live.nevermined.app/api/v1
    description: Live
security: []
tags:
  - name: Organizations
    x-group: General
    description: Organization settings, members & roles, and workspace context.
  - name: Organizations - Billing
    x-group: Billing
    description: Tiers, subscriptions, invoices, checkout, and the public tier catalog.
  - name: Groups
    x-group: Groups & Budgets
    description: Organization groups, per-group budgets, and shared payment methods.
  - name: Organizations - Wallets
    x-group: Wallets
    description: Custodial stablecoin treasury wallets.
  - name: Organizations - Customers
    x-group: Customers
    description: The white-label customer CRM (Enterprise).
  - name: Organizations - Analytics
    x-group: Analytics
    description: Revenue, MRR, usage, conversion, and per-member metrics.
  - name: Organizations - Webhooks
    x-group: Webhooks
    description: Outbound webhook subscriptions and deliveries.
  - name: Organizations - Activity
    x-group: Activity
    description: The organization activity feed.
  - name: Organizations - Realtime
    x-group: Realtime
    description: Realtime WebSocket secret management (Enterprise).
  - name: Invitations
    x-group: Invitations
    description: Invite people to an organization.
  - name: Organizations - Integration
    x-group: Agent Discovery
    description: >-
      Public agent-discovery surfaces (llms.txt, agentic-instructions.md,
      ai-catalog.json).
paths:
  /organizations/members:
    post:
      tags:
        - Organizations
      summary: Search the members of an organization
      description: >-
        Returns a paginated list of the members of the caller organization,
        optionally filtered by role and active status, alongside the total count
        of active admins (used to guard "last admin" actions across pages). The
        organization is resolved from the authenticated context, not from the
        request body. Read-only — any active member (not just admins) may call
        it. Requires a Nevermined API key.
      operationId: OrganizationsController_getOrganizationMembers
      parameters: []
      requestBody:
        required: true
        description: Optional role/active filters and pagination for the members search.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchOrganizationMembersDto'
      responses:
        '200':
          description: Paginated organization members with the total active-admin count.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationMembersPageDto'
        '400':
          description: Bad Request
        '403':
          description: Caller is not an active member of the organization.
        '404':
          description: Not Found
      security:
        - Authorization: []
components:
  schemas:
    SearchOrganizationMembersDto:
      type: object
      properties:
        role:
          type: string
          enum:
            - Admin
            - Member
          example: Admin
          description: Role of the organization member
        isActive:
          type: boolean
          example: true
          description: Active status of the organization member
        page:
          type: number
          example: 1
          description: Page of the organization members list
        offset:
          type: number
          example: 20
          description: Page offset of the organization members list
        environment:
          type: string
          example: sandbox
          description: Environment to get stripe account id from (live or sandbox)
          enum:
            - live
            - sandbox
      required:
        - role
        - isActive
        - page
        - offset
        - environment
    OrganizationMembersPageDto:
      type: object
      properties:
        totalResults:
          type: number
          example: 137
          description: Total number of results found
        members:
          description: List of organization members with profile information
          type: array
          items:
            $ref: '#/components/schemas/OrganizationMemberWithProfileDto'
        page:
          type: number
          example: 1
          description: Page of the notifications list
        offset:
          type: number
          example: 20
          description: Page offset of the notifications list
        totalActiveAdmins:
          type: number
          example: 2
          description: >-
            Total number of ACTIVE admins in the organization (not just on this
            page). Used by the webapp to guard "demote / deactivate / remove
            last admin" actions when the relevant admin sits on a different page
            than the viewer.
      required:
        - totalResults
        - members
        - page
        - offset
        - totalActiveAdmins
    OrganizationMemberWithProfileDto:
      type: object
      properties:
        name:
          type: string
          example: John Doe
          description: Name of the user
          nullable: true
        stripeAccountId:
          type: string
          example: acct_1234567890
          description: Stripe account ID for the current environment
          nullable: true
      required:
        - name
        - stripeAccountId
  securitySchemes:
    Authorization:
      scheme: bearer
      bearerFormat: JWT
      type: http

````

## Related topics

- [Reactivate an organization member](/docs/api-reference/organizations/reactivate-an-organization-member.md)
- [Deactivate an organization member](/docs/api-reference/organizations/deactivate-an-organization-member.md)
- [Remove an organization member](/docs/api-reference/organizations/remove-an-organization-member.md)
- [Change an organization member role](/docs/api-reference/organizations/change-an-organization-member-role.md)
- [Add an organization member to a group](/docs/api-reference/groups/add-an-organization-member-to-a-group.md)
