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

# List Users

> Returns a list of all users in the organization.



## OpenAPI

````yaml GET /api/v1/organizations/{org_id}/users
openapi: 3.1.0
info:
  title: Organization Management API
  version: 1.0.0
servers:
  - url: https://anaconda.com
    description: Anaconda Cloud
security: []
paths:
  /api/v1/organizations/{org_id}/users:
    get:
      tags:
        - organizations
      summary: List Users
      description: Returns a list of all users in the organization.
      operationId: list_users
      parameters:
        - name: org_id
          in: path
          required: true
          schema:
            type: string
          description: >-
            Your organization ID, found in your organization's URL:
            `anaconda.com/app/organizations/<ORG_ID>/`.
        - name: include_groups
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: >-
            Set to `true` to include each user's group memberships in the
            response.
      responses:
        '200':
          description: List of organization users
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationUserList'
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - JWT or Access Token: []
components:
  schemas:
    OrganizationUserList:
      type: object
      required:
        - items
      properties:
        items:
          type: array
          description: A list of users in the organization.
          items:
            $ref: '#/components/schemas/OrganizationUser'
    HTTPValidationError:
      type: object
      properties:
        detail:
          type: array
          description: A list of validation errors.
          items:
            $ref: '#/components/schemas/ValidationError'
    OrganizationUser:
      type: object
      required:
        - id
        - email
        - role
        - subscriptions
      properties:
        id:
          type: string
          format: uuid
          description: The unique identifier for this user.
        email:
          type: string
          format: email
          description: The email address of this user.
        first_name:
          type:
            - string
            - 'null'
          description: The first name of this user.
        last_name:
          type:
            - string
            - 'null'
          description: The last name of this user.
        role:
          $ref: '#/components/schemas/UserOrganizationRole'
        subscriptions:
          type: array
          items:
            type: string
          description: The subscription product codes assigned to this user.
        groups:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/UserGroupSchema'
          description: >-
            The groups this user belongs to. Only populated when
            `include_groups=true` is passed.
    ValidationError:
      type: object
      required:
        - loc
        - msg
        - type
      properties:
        loc:
          type: array
          items:
            type: string
          description: >-
            The location of the validation error (for example, `["body",
            "name"]`).
        msg:
          type: string
          description: A human-readable validation error message.
        type:
          type: string
          description: The type of validation error.
    UserOrganizationRole:
      type: string
      enum:
        - member
        - admin
        - billing_manager
      description: The role of the user within the organization.
    UserGroupSchema:
      type: object
      required:
        - id
        - name
        - org_id
        - created_at
        - updated_at
        - user_count
      properties:
        id:
          type: string
          format: uuid
          description: The unique identifier for this group.
        name:
          type: string
          description: The name of this group.
        org_id:
          type: string
          format: uuid
          description: The organization ID this group belongs to.
        created_at:
          type: string
          format: date-time
          description: When this group was created.
        updated_at:
          type:
            - string
            - 'null'
          format: date-time
          description: When this group was last updated.
        user_count:
          type: integer
          description: The number of users in this group.
  securitySchemes:
    JWT or Access Token:
      bearerFormat: JWT
      description: >-
        Bearer token obtained by authenticating with [service
        account](/anaconda-platform/admin/service-accounts) credentials
        (`client_id` and `client_secret`).


        See the [Getting
        started](/anaconda-platform/admin/org-management-api/org-management-api)
        page for the full authentication flow.
      scheme: bearer
      type: http

````