---
title: "Lists the non-members of a specific user group."
method: GET
path: "/accessmanagement/usergroups/{userGroupId}/nonmembers"
tags: ["accessmanagement - user groups"]
---

# Lists the non-members of a specific user group.

`GET /accessmanagement/usergroups/{userGroupId}/nonmembers`

## Request

- Base URL: `https://manager.digicertdns.com/v1`
- URL: `https://manager.digicertdns.com/v1/accessmanagement/usergroups/{userGroupId}/nonmembers`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/digicert/apis/digicert-dns/docs/accessmanagement/usergroups/:userGroupId/nonmembers/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint lists the users not currently assigned to a specific user group, helping users identify candidates for group membership.</br></br>Key features include:</br></br>- **Clear success messaging:** Returns a `200` success code with a confirmation message indicating the successful completion of the requested action.</br>- **Comprehensive error handling:** Returns `400` and `404` error codes with clear descriptions when requests fail.</br>- **Dynamic filtering:** Uses the `type` parameter to filter results, streamlining access to specific users and enhancing data retrieval efficiency.</br>- **Search term filtering:** Uses the `searchTerm` parameter to filter results by matching user usernames or email addresses, enabling quick and precise user lookup.</br>- **Targeted data retrieval:** Employs the `userGroupId` parameter to return the specified user group's first 500 non-members, ensuring accuracy and relevance in the response.

## Path parameters

- `userGroupId` integer, required

## Query parameters

- `searchTerm` string
- `type` 'user' | 'service'

## Response `200`

Non-members listed successfully.

- UserGroupUserPaginated
  - `data` UserGroupUser[]
    - `id` integer
    - `userId` integer
    - `name` string
    - `email` string, email
    - `username` string
    - `canDelete` boolean
    - `type` 'USER' | 'SERVICE'
  - `total` integer
  - `count` integer
  - `perPage` integer
  - `currentPage` integer
  - `totalPages` integer

## Other responses

- `400`: Request is malformed or invalid.
- `404`: Resource not found.

---

[API](https://skmtc.dev/digicert/apis/digicert-dns.md) - [All operations](https://skmtc.dev/digicert/apis/digicert-dns/llms.txt) - [OpenAPI document](https://skmtc.dev/digicert/apis/digicert-dns/revisions/c74fc728cff8?raw)