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

# List group members

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns one page of a group's members, sorted by email. Set `search` to match part of a member's email or name.

To page, keep requesting with `offset` increased by the number of members returned while `has_more` is `true`.

Members your identity provider sent who don't have a Base44 account in the workspace yet aren't listed. [List workspace groups](/api-reference/list-workspace-groups) counts them in `unresolved_count`.

This is limited to 120 requests per minute, shared with [List workspace groups](/api-reference/list-workspace-groups). A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit.

<Note>Call this as an owner, admin, or editor of the workspace, with a personal access token for that workspace sent as a Bearer token, or from a signed-in session. A read-only token is refused even though this endpoint only reads, and workspace API keys aren't accepted.</Note>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/workspace/groups/{group_id}/members
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/workspace/groups/{group_id}/members:
    get:
      summary: List group members
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Returns one page of a group's members, sorted by email. Set `search` to
        match part of a member's email or name.


        To page, keep requesting with `offset` increased by the number of
        members returned while `has_more` is `true`.


        Members your identity provider sent who don't have a Base44 account in
        the workspace yet aren't listed. [List workspace
        groups](/api-reference/list-workspace-groups) counts them in
        `unresolved_count`.


        This is limited to 120 requests per minute, shared with [List workspace
        groups](/api-reference/list-workspace-groups). A signed-in session has
        its own limit, and every personal access token for the workspace shares
        one. Some workspaces have a different limit.


        <Note>Call this as an owner, admin, or editor of the workspace, with a
        personal access token for that workspace sent as a Bearer token, or from
        a signed-in session. A read-only token is refused even though this
        endpoint only reads, and workspace API keys aren't accepted.</Note>
      operationId: list_group_members_api_workspace_groups__group_id__members_get
      parameters:
        - name: group_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the group whose members to list. Get it from `id` in [List
              workspace groups](/api-reference/list-workspace-groups).
            title: Group Id
          description: >-
            ID of the group whose members to list. Get it from `id` in [List
            workspace groups](/api-reference/list-workspace-groups).
          example: 68b4e1d2c9a7f3001e2d4b61
        - name: workspaceId
          in: query
          required: true
          schema:
            type: string
            minLength: 1
            description: >-
              ID of the workspace. With a personal access token, use the token's
              workspace. Get it from `organization_id` in [Get
              app](/api-reference/get-app).
            title: Workspaceid
          description: >-
            ID of the workspace. With a personal access token, use the token's
            workspace. Get it from `organization_id` in [Get
            app](/api-reference/get-app).
          example: 67e0b12c4d8a3f005b21c9e4
        - name: search
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 254
              - type: 'null'
            description: >-
              Only return members whose email or name contains this text,
              ignoring case. Up to 254 characters.
            title: Search
          description: >-
            Only return members whose email or name contains this text, ignoring
            case. Up to 254 characters.
          example: dana
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            description: Number of members to skip. Defaults to 0.
            default: 0
            title: Offset
          description: Number of members to skip. Defaults to 0.
          example: 0
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 200
            minimum: 1
            description: Number of members to return, from 1 to 200. Defaults to 50.
            default: 50
            title: Limit
          description: Number of members to return, from 1 to 200. Defaults to 50.
          example: 50
      responses:
        '200':
          description: One page of the group's members.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupMembersPage'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            You aren't an owner, admin, or editor of the workspace, your token
            is for a different workspace or is read-only, or your credential
            can't be used on this endpoint.
        '404':
          description: Group not found in this workspace.
        '409':
          description: Your workspace requires an unlocked SSO session.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '429':
          description: Rate limit exceeded.
components:
  schemas:
    GroupMembersPage:
      properties:
        members:
          items:
            $ref: '#/components/schemas/GroupMemberItem'
          type: array
          title: Members
          description: Members on this page, sorted by email.
          example:
            - email: dana@acme.com
              full_name: Dana Levi
              user_id: 6820f41be7b91d003c45a20a
        total:
          type: integer
          title: Total
          description: Number of members that match `search`, across all pages.
          example: 12
        has_more:
          type: boolean
          title: Has More
          description: Whether more members follow this page.
          example: false
      type: object
      required:
        - members
        - total
        - has_more
      title: GroupMembersPage
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    GroupMemberItem:
      properties:
        email:
          type: string
          title: Email
          description: Email of the member.
          example: dana@acme.com
        user_id:
          anyOf:
            - type: string
            - type: 'null'
          title: User Id
          description: ID of the member's Base44 user.
          example: 6820f41be7b91d003c45a20a
        full_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Full Name
          description: Member's name, or `null` when none is set.
          example: Dana Levi
        profile_image_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Profile Image Url
          description: URL of the member's profile image, or `null` when none is set.
          example: https://lh3.googleusercontent.com/a/ACg8ocJ2
      type: object
      required:
        - email
      title: GroupMemberItem
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: 'Personal access token, sent as `Authorization: Bearer <token>`.'

````

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