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

# List members of a specific organization (Admin only)

> Returns the members of the given organization with full user details
(email, last login, active status), consistent with `/v1/admin/users`.
Only authenticated admins can perform this operation.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/admin/organizations/{org_id}/members
openapi: 3.1.0
info:
  title: NEAR AI Cloud API
  description: >-
    NEAR AI Cloud API for private AI model inference and organization
    administration.
  contact:
    name: NEAR AI Team
    email: support@near.ai
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://cloud-api.near.ai
    description: NEAR AI Cloud
security:
  - session_token: []
  - api_key: []
tags:
  - name: Chat
    description: Chat completion endpoints for AI model inference
  - name: Images
    description: Image generation endpoints
  - name: Audio
    description: Audio transcription endpoints
  - name: Rerank
    description: Document reranking endpoints
  - name: Score
    description: Text similarity scoring endpoints
  - name: Privacy
    description: Privacy classification (PII span detection) endpoints
  - name: Models
    description: Public model catalog and information
  - name: Responses
    description: >-
      Stateless response inference (`store: false` only). Raw request/response
      content, response items, and history are not persisted. Clients must
      include any prior context in each request. Every successful Responses
      inference makes exactly one Chat Completions call. Only custom `function`
      tools are supported. They are client-managed: Cloud returns
      `function_call` items but never executes them; a later `store: false`
      request replays the individual call (the raw item from output is accepted)
      with its matching `function_call_output`, alongside caller-managed message
      history and the same function tool definitions. The minimal replay path
      also accepts assistant `message` text parts of type `output_text`, but not
      reasoning or arbitrary full `response.output` items. Server-executed tools
      (`web_search`, `web_context_search`, `file_search`, `code_interpreter`,
      `computer`, and remote `mcp`) and image-generation/editing models are
      rejected. The separate `POST /mcp` endpoint continues to expose its
      `web_search` tool independently of Responses; use `/v1/images/*` for image
      generation/editing. Existing completed-response gateway attestation is
      preserved best-effort: when the signature write succeeds, `GET
      /v1/signature/resp_*` retrieves signatures over SHA-256 request/response
      digests, never raw content. Interrupted streams create no `resp_*`
      attestation record or legacy disconnect fallback. Conversations, response
      history, and file input are rejected.
  - name: Organizations
    description: Organization management
  - name: Organization Members
    description: Organization member and invitation management
  - name: Workspaces
    description: Workspace and API key management
  - name: Users
    description: User profile and token management
  - name: Invitations
    description: Token-based invitation handling
  - name: Usage
    description: Usage tracking and billing information
  - name: Reporting
    description: Read-only customer usage reporting
  - name: Billing
    description: Billing costs endpoint (HuggingFace integration)
  - name: Staking Farm
    description: House of Stake farm credit configuration and synchronization
  - name: Health
    description: Health check endpoints
  - name: Attestation
    description: Attestation and verification endpoints
  - name: Gateway
    description: Model gateway integration endpoints
  - name: Admin
    description: Administrative endpoints (admin access required)
  - name: Services
    description: Public platform services (e.g. web_search pricing)
paths:
  /v1/admin/organizations/{org_id}/members:
    get:
      tags:
        - Admin
      summary: List members of a specific organization (Admin only)
      description: |-
        Returns the members of the given organization with full user details
        (email, last login, active status), consistent with `/v1/admin/users`.
        Only authenticated admins can perform this operation.
      operationId: list_organization_members
      parameters:
        - name: org_id
          in: path
          description: Organization ID
          required: true
          schema:
            type: string
            format: uuid
        - name: limit
          in: query
          description: 'Maximum number of members to return (default: 100)'
          required: false
          schema:
            type: integer
            format: int64
        - name: offset
          in: query
          description: 'Number of members to skip (default: 0)'
          required: false
          schema:
            type: integer
            format: int64
      responses:
        '200':
          description: Organization members retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListAdminOrganizationMembersResponse'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Organization not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - session_token: []
components:
  schemas:
    ListAdminOrganizationMembersResponse:
      type: object
      description: >-
        List organization members response model (admin only).

        Exposes full user details (email, last login, active status) for each
        member.
      required:
        - members
        - total
        - limit
        - offset
      properties:
        limit:
          type: integer
          format: int64
        members:
          type: array
          items:
            $ref: '#/components/schemas/AdminOrganizationMemberResponse'
        offset:
          type: integer
          format: int64
        total:
          type: integer
          format: int64
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
    AdminOrganizationMemberResponse:
      type: object
      description: |-
        Admin organization member response (for owners/admins)
        Contains member info with full user details including sensitive data
      required:
        - id
        - organization_id
        - role
        - joined_at
        - user
      properties:
        id:
          type: string
        invited_by:
          type:
            - string
            - 'null'
        joined_at:
          type: string
          format: date-time
        organization_id:
          type: string
        role:
          $ref: '#/components/schemas/MemberRole'
        user:
          $ref: '#/components/schemas/AdminUserResponse'
    ErrorDetail:
      type: object
      required:
        - message
        - type
      properties:
        code:
          type:
            - string
            - 'null'
        message:
          type: string
        param:
          type:
            - string
            - 'null'
        type:
          type: string
    MemberRole:
      type: string
      description: Member role enum for API
      enum:
        - owner
        - admin
        - member
    AdminUserResponse:
      type: object
      description: >-
        Admin user response model (for owners/admins)

        Contains sensitive information only visible to organization
        owners/admins
      required:
        - id
        - email
        - created_at
        - is_active
        - auth_provider
        - provider_user_id
      properties:
        auth_provider:
          type: string
        avatar_url:
          type:
            - string
            - 'null'
        created_at:
          type: string
          format: date-time
        display_name:
          type:
            - string
            - 'null'
        email:
          type: string
        id:
          type: string
        is_active:
          type: boolean
        last_login_at:
          type:
            - string
            - 'null'
          format: date-time
        organizations:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/AdminUserOrganizationDetails'
        provider_user_id:
          type: string
        username:
          type:
            - string
            - 'null'
    AdminUserOrganizationDetails:
      type: object
      description: Organization details with spend limit and usage (for admin user listing)
      required:
        - id
        - name
      properties:
        currentUsage:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/OrganizationUsage'
        description:
          type:
            - string
            - 'null'
        id:
          type: string
        name:
          type: string
        spendLimit:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/SpendLimit'
    OrganizationUsage:
      type: object
      description: |-
        Organization usage information (for admin user listing)
        All costs use fixed scale of 9 (nano-dollars) and USD currency
      required:
        - total_spent
        - total_spent_display
        - total_requests
        - total_tokens
      properties:
        total_requests:
          type: integer
          format: int64
          description: Total number of API requests
        total_spent:
          type: integer
          format: int64
          description: Total amount spent in nano-dollars (scale 9)
        total_spent_display:
          type: string
          description: Human readable total spent, e.g., "$12.50"
        total_tokens:
          type: integer
          format: int64
          description: Total number of tokens used
    SpendLimit:
      type: object
      description: >-
        Spend limit for API responses


        The system uses a fixed scale of 9 (nano-dollars = 1 billionth of a
        dollar).

        The scale field is included in responses for client convenience.


        Examples:
          $100.00 USD: amount=100000000000, scale=9, currency="USD"
          $0.01 USD: amount=10000000, scale=9, currency="USD"
      required:
        - amount
        - scale
        - currency
      properties:
        amount:
          type: integer
          format: int64
        currency:
          type: string
        scale:
          type: integer
          format: int64
  securitySchemes:
    session_token:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        JWT access token for user authentication (Authorization: Bearer
        <jwt_token>). Create via POST /users/me/access_tokens.
    api_key:
      type: http
      scheme: bearer
      bearerFormat: api_key
      description: 'API key for programmatic access (Authorization: Bearer sk-<api_key>)'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.