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

# List Group Members

> Who is in a group, including people who have not accepted yet.

Returns the members of one group. Everybody listed here holds every grant the group holds.

## Response

An array of [user objects](/platform-api/users/user). This endpoint is not paginated.

```json theme={null}
[
  {
    "id": 12,
    "first_name": "Dana",
    "last_name": "Reed",
    "email": "dana@example.com",
    "role": "member",
    "is_active": true,
    "is_pending": false
  },
  {
    "id": 42,
    "first_name": "",
    "last_name": "",
    "email": "analyst@example.com",
    "role": "member",
    "is_active": false,
    "is_pending": true
  }
]
```

<Note>
  **Invited people appear here.** `is_pending: true` with `is_active: false` is somebody who has been invited and has not accepted — they hold the group's grants already, and accepting is what lets them sign in and use them. See [Onboarding flow](/platform-api/invitations/overview).
</Note>

Deactivated members are not listed. They were switched off deliberately, and their access is gone regardless of what group they were in.

## Related

* [Add Members](/platform-api/permission-groups/add-members) — putting somebody in.
* [Remove Members](/platform-api/permission-groups/remove-members) — taking them out.
* [Retrieve a Group](/platform-api/permission-groups/details) — membership plus the grants the group holds.


## OpenAPI

````yaml GET /api/v1/organization/permission-groups/{permission_group_pk}/users/
openapi: 3.0.3
info:
  title: Nekt API
  version: v1
  description: Nekt API Documentation
  contact:
    email: support@nekt.ai
servers:
  - url: https://api.nekt.ai
security: []
paths:
  /api/v1/organization/permission-groups/{permission_group_pk}/users/:
    get:
      tags:
        - v1
      summary: List the users in a permission group
      operationId: v1_organization_permission_groups_users_list
      parameters:
        - in: path
          name: permission_group_pk
          schema:
            type: string
            format: uuid
          description: The permission group's id.
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OrganizationUser'
          description: ''
      security:
        - ApiKeyAuth: []
components:
  schemas:
    OrganizationUser:
      type: object
      properties:
        id:
          type: integer
          readOnly: true
        first_name:
          type: string
          readOnly: true
        last_name:
          type: string
          readOnly: true
        email:
          type: string
          format: email
          readOnly: true
          title: Email address
        picture:
          type: string
          format: uri
          readOnly: true
          nullable: true
        role:
          type: string
          readOnly: true
        functional_area:
          readOnly: true
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/FunctionalAreaEnum'
            - $ref: '#/components/schemas/NullEnum'
        other_functional_area:
          type: string
          readOnly: true
          nullable: true
        date_joined:
          type: string
          format: date-time
          readOnly: true
        last_login:
          type: string
          format: date-time
          readOnly: true
          nullable: true
        is_active:
          type: boolean
          readOnly: true
          default: false
        is_pending:
          type: boolean
          readOnly: true
          default: false
      required:
        - date_joined
        - email
        - first_name
        - functional_area
        - id
        - is_active
        - is_pending
        - last_login
        - last_name
        - other_functional_area
        - picture
        - role
    FunctionalAreaEnum:
      enum:
        - data_analytics
        - sales
        - customer_support
        - operations
        - marketing
        - finance
        - product_development
        - growth
        - executive_leadership
        - other
      type: string
      description: |-
        * `data_analytics` - Data & Analytics
        * `sales` - Sales
        * `customer_support` - Customer Support
        * `operations` - Operations
        * `marketing` - Marketing
        * `finance` - Finance
        * `product_development` - Product Development
        * `growth` - Growth
        * `executive_leadership` - Executive Leadership
        * `other` - Other
    NullEnum:
      enum:
        - null
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: 'API Key authentication. Format: ''x-api-key: api_key'''

````