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

# List organization members

> Retrieves the list of users who belong to the authenticated organization. Banned members are filtered out of the response. The `email` field is only returned to callers with `owner` or `admin` role — lower-privileged members receive the same payload without `email` to prevent directory enumeration.



## OpenAPI

````yaml https://app.stainless.com/api/spec/documented/avido/openapi.documented.yml get /v0/organization-members
openapi: 3.1.1
info:
  title: Avido API
  description: >-
    Avido's API for LLM usage events, tool calls, trace management, webhook
    validation, and more. See each endpoint's request/response schema for
    details.
  version: 0.1.0
  contact:
    name: Avido Support
    email: support@avidoai.com
    url: https://avidoai.com/support
servers:
  - url: https://api.avidoai.com
    description: Production API
security:
  - ApiKey: []
    ApplicationId: []
paths:
  /v0/organization-members:
    get:
      tags:
        - Organization Members
      summary: List organization members
      description: >-
        Retrieves the list of users who belong to the authenticated
        organization. Banned members are filtered out of the response. The
        `email` field is only returned to callers with `owner` or `admin` role —
        lower-privileged members receive the same payload without `email` to
        prevent directory enumeration.
      operationId: listOrganizationMembers
      responses:
        '200':
          description: Successfully retrieved the list of non-banned organization members
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationMembersResponse'
              examples:
                adminCaller:
                  summary: Response for owner/admin callers
                  value:
                    data:
                      - id: 123e4567-e89b-12d3-a456-426614174000
                        email: ada@example.com
                        firstName: Ada
                        lastName: Lovelace
                        profilePictureUrl: https://cdn.example.com/avatars/ada.png
                        banned: false
                memberCaller:
                  summary: Response for non-admin callers (email omitted)
                  value:
                    data:
                      - id: 123e4567-e89b-12d3-a456-426614174000
                        firstName: Ada
                        lastName: Lovelace
                        profilePictureUrl: https://cdn.example.com/avatars/ada.png
                        banned: false
        '400':
          description: bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationErrorResponse'
        '500':
          description: internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    OrganizationMembersResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/OrganizationMember'
      required:
        - data
      additionalProperties: false
      title: OrganizationMembersResponse
      description: >-
        Successful response containing the list of non-banned members of the
        authenticated organization.
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
          description: A human-readable error message explaining the error.
          example: Resource not found
      required:
        - message
      additionalProperties: false
      title: ErrorResponse
      description: Standard error format for failed API operations.
    ValidationErrorResponse:
      type: object
      properties:
        message:
          type: string
          description: A human-readable error message indicating what went wrong.
          example: Invalid request data
        issues:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
              message:
                type: string
              path:
                type: array
                items:
                  type: string
            required:
              - code
              - message
              - path
            additionalProperties: false
          description: Array of detailed validation error objects.
          example:
            - code: invalid_string
              message: Invalid UUID
              path:
                - id
      required:
        - message
        - issues
      additionalProperties: false
      title: ValidationErrorResponse
      description: Details about validation errors in incoming requests.
    OrganizationMember:
      type: object
      properties:
        id:
          type: string
          description: >-
            The user's unique identifier (format depends on the auth provider —
            not guaranteed to be a UUID)
          example: abc123def456
        email:
          description: >-
            The user's email address. Only returned to callers with `owner` or
            `admin` role in the organization; omitted for lower-privileged
            members to prevent directory enumeration.
          example: user@example.com
          type: string
        firstName:
          type: string
          minLength: 1
          description: The user's first name
          example: Ada
        lastName:
          type: string
          minLength: 1
          description: The user's last name
          example: Lovelace
        profilePictureUrl:
          type: string
          description: >-
            URL of the user's profile picture. Either a customer-uploaded image
            or a deterministic FaceHash avatar derived from the user id; never
            derived from email.
          example: https://cdn.example.com/avatars/ada.png
        banned:
          type: boolean
          description: >-
            Whether the user is banned. Always `false` in responses from this
            endpoint — banned members are filtered out.
          example: false
      required:
        - id
        - firstName
        - lastName
        - profilePictureUrl
        - banned
      additionalProperties: false
      title: OrganizationMember
      description: >-
        A user who belongs to the authenticated organization. Banned members are
        excluded from list responses.
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your unique Avido API key
    ApplicationId:
      type: apiKey
      in: header
      name: x-application-id
      description: Your unique Avido Application ID

````