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

# List Users

> List all users in the current workspace.

Requires members:read scope (admin / analyst / viewer all have it).
The full user shape includes role and membership_id for admin UI consumption.



## OpenAPI

````yaml /openapi.json get /v1/users
openapi: 3.1.0
info:
  description: Causeloop Platform Backend
  title: Causeloop API
  version: 1.0.0
servers: []
security: []
paths:
  /v1/users:
    get:
      tags:
        - users
      summary: List Users
      description: >-
        List all users in the current workspace.


        Requires members:read scope (admin / analyst / viewer all have it).

        The full user shape includes role and membership_id for admin UI
        consumption.
      operationId: list_users_v1_users_get
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserListResponse'
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    UserListResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/app__routers__users__UserOut'
          title: Data
          type: array
        total:
          title: Total
          type: integer
      required:
        - data
        - total
      title: UserListResponse
      type: object
    app__routers__users__UserOut:
      properties:
        avatar_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Avatar Url
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Created At
        email:
          title: Email
          type: string
        external_id:
          anyOf:
            - type: string
            - type: 'null'
          title: External Id
        id:
          title: Id
          type: string
        locale:
          default: en
          title: Locale
          type: string
        membership_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Membership Id
        name:
          title: Name
          type: string
        role:
          anyOf:
            - type: string
            - type: 'null'
          title: Role
        timezone:
          default: UTC
          title: Timezone
          type: string
        workspace_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Workspace Id
      required:
        - id
        - email
        - name
      title: UserOut
      type: object
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http

````