# Get All Users of a User Group

## Request

```CURL
GET [[[<REST API URL>|Hub-Rest-Api-URL.html]]]/usergroups/user group id/users?fields=string&amp;$skip=int&amp;$top=int&amp;query=string&amp;orderBy=string
```

|  Parameter  |  Description  |
| --- | --- |
|  `fields`  |  Optional. Returns only the specified subset of the fields for each User. Use [Fields Syntax](hub-api-fields-syntax.html) to define the subset.  |
|  `$skip`  |  Optional. Lets you set a number of Users to skip before returning the first one.  |
|  `$top`  |  Optional. Lets you set the maximum number of Users to return.  |
|  `query`  |                            Optional. Lets you specify a search query to filter the returned results. See [Query Syntax](hub-api-query-syntax.html) for the definition of supported logical operations syntax. For the Users, the following fields and tuples are supported:     authLogin: userAzureLogin — Users with the given Azure identifier      authName: userAzureName — Users with the given name provided by Azure      authLogin: userGithubLogin — Users with the given GitHub login      authName: value — Users with the given name provided by GitHub      authName: userGoogleName — Users with the given name provided by Google      googleID: value — Users with the given Google identifier      authLogin: userJBALogin — Users with the given JetBrains account login      authLogin: userJiraLogin — Users with the given Jira login      authName: userJiraName — Users with the given name provided by JetBrains account      authLogin: userLdapLogin — Users with the given LDAP user ID      authName: value — Users with the given name provided by LDAP      authName: userOpenIDName — Users with the given name provided by OpenID      openID: value — Users with the given OpenID identifier      authName: userSamlName — Users with the given name provided by SAML      access(project: project, with: role) — Returns a list of users with the specified role assigned in the specified project      access(project: project) — Returns a list of users with any role assigned in the specified project      access(with: role) — Returns a list of users with the specified role assigned anywhere      access(with: permission) — Returns a list of users with the specified permission granted anywhere      after: instant — Returns a list of users that were created after the specified moment      authEmail: email — Returns a list of users with the specified email in their user details      authLogin: userCoreLogin — Returns a list of users with the specified login in their user details      authMethod: authModule — Returns a set of users with user details associated with the specified auth module      authModule: authModule — Users with user details associated with the specified auth module      authUsername: userCoreLogin — Returns a list of users with the specified username in their user details      banStatus: ban status — Returns a set of banned users with a certain status      before: instant — Returns a list of users that were created before the specified moment      email: email — Users with the specified email      group: group — Returns members of the specified group      has: lastAccess — Returns a list of users that logged in at least once      has: ownRole — Returns a list of users with any role that was granted directly      has: group — Returns a list of users that are added to any group explicitly      has: 2FA — Returns a list of users who enabled two-factor authentication      has: authMethod — Users with some user details      has: email — Users with defined email      has: verifiedEmail — Returns a list of users with verified emails      has: originService — Returns a list of users with user details that were imported from any service      has: login — Returns a list of users that have login      has: sshPublicKey — Returns a list of users with an SSH public key      has: approved resource — Returns a list of users with approved resources      has: refresh token — Returns a list of users with refresh tokens      has: permanent token — Returns a list of users with created permanent tokens      has: accepted end-user agreement — Returns a list of users that accepted current version of the end-user agreement      id: value — User with the given ID      in: group — Returns a list of users that are members of the specified group or any of its subgroups      is: guest — Returns the guest user      is: banned — Returns a list of banned users      is: supporting2FA — Returns a list of users with credentials that can use two-factor authentication      lastAccess(after: instant) — Returns a list of users that logged into Hub after the specified moment      lastAccess(before: instant) — Returns a list of users that logged into Hub before the specified moment      lastAccess(after: instant, before: instant) — Returns a list of users that logged into Hub during the specified period of time      login: userLogin — Returns a list of users with the specified login      name: userName — Returns a list of users with the specified full name      nameStartsWith: value — Returns a list of users with names or logins that start with the specified prefix      originService: service — Returns a list of users with user details that were imported from the specified service      ownRole: role — Returns a list of users with the specified role that was granted directly in any project or organization      sshPublicKey: value — Returns a user with the specified SSH public key      username: userUsername — Returns a list of users with the specified username     |
|  `orderBy`  |  Optional. Returns the list of Users sorted by a specified field. See [Sorting Syntax](hub-api-sort-syntax.html) for details. Users support ordering by the following fields: creationTime, lastAccessTime, login, name, username  |

## Response

|  Response Code  |  Meaning  |
| --- | --- |
|  200 OK  |  Successful request.  |
|  400 Bad Request  |  At least one of the request parameters is invalid. For example, a required field in the passed JSON object is missing. For details, check the error message in the response.  |
|  403 Forbidden  |  The requester has no access to the requested resource.  |
|  404 Not Found  |  The requested resource was not found.  |
|  500 Internal Server Error  |  Failed to process request because of the server error. For details, check the error message in the response.  |

### Response body

```JSON
{
  "skip": int, 
  "top": int, 
  "total": int, 
  "users": [[[[user|HUB-REST-API_JSON-Scheme.html#user]]], ...]
}
```

