# Users

This resource lets you read the users in the project team.
Available since YouTrack 2026.1.

|  Resource  |     ```GENERIC /api/admin/projects/{projectID}/team/users ```    |
| --- | --- |
|  Returned entity  |  [User](api-entity-User.html). For the description of the entity attributes, see [Supported Fields](#User-supported-fields) section.  |
|  Supported methods  |      * `GET`: [Read a List of Users](#get_all-User-method).    |

## User attributes

Represents a user in YouTrack. Please note that the read-only properties of a user account, like credentials, or email and so on, you can only change in [Hub REST API](https://www.jetbrains.com.cn/en-us/help/youtrack/devportal/?Hub-REST-API).

### Related Resources

Below you can find the list of resources that let you work with this entity.

* [Users](resource-api-users.html)

* [Individual Users in the Bundle](resource-api-admin-customFieldSettings-bundles-user-bundleID-individuals.html)

* [Aggregated Users in the Bundle](resource-api-admin-customFieldSettings-bundles-user-bundleID-aggregatedUsers.html)

### Attributes

This table describes attributes of the `User` entity.

* To receive an attribute in the response from the server, specify it explicitly in the `fields` request parameter.

* To update an attribute, provide it in the body of a POST request.

|  Field  |  Type  |  Description  |
| --- | --- | --- |
|  id  |  String  |  The ID of the user. `Read-only`.  |
|  login  |  String  |  The login of the user. `Read-only`.  |
|  fullName  |  String  |  The full name of the user as seen in their profile. `Read-only`.  |
|  email  |  String  |  The email address of the user. `Read-only`. `Can be null`.  |
|  ringId  |  String  |  ID of the user in Hub. You can use this ID for operations in Hub, and for matching users between YouTrack and Hub. `Read-only`. `Can be null`.  |
|  guest  |  Boolean  |  Indicates whether the user is `guest`. `Read-only`.  |
|  online  |  Boolean  |  Indicates whether the user is currently online. `Read-only`.  |
|  banned  |  Boolean  |  Indicates whether the user is banned. `Read-only`.  |
|  banBadge  |  String  |  The badge displayed for the banned user. Returns `null` when no badge is set or the ban details are not available to the requester. `Read-only`. `Can be null`.  |
|  banReason  |  String  |  The reason why the user is banned. Returns `null` when no reason is set or the ban details are not available to the requester. `Read-only`. `Can be null`.  |
|  isAnonymized  |  Boolean  |  Indicates whether the user's personal data has been anonymized. `Read-only`.  |
|  tags  |  [Array of Tags](api-entity-Tag.html)  |  Tags that belong to this user. `Read-only`.  |
|  savedQueries  |  [Array of SavedQueries](api-entity-SavedQuery.html)  |  Saved searches that belong to this user. `Read-only`.  |
|  avatarUrl  |  String  |  The URL of the user avatar. `Read-only`.  |
|  profiles  |  [UserProfiles](api-entity-UserProfiles.html)  |  The profiles of the user. `Read-only`.  |
|  userType  |  [UserType](api-entity-UserType.html)  |  The type of the user.    Available since YouTrack 2026.2.    `Read-only`.  |

## Read a List of Users

Read the list of all users in the project team, including users from groups added to the team.

### Required permissions

Requires permissions: Read Project Basic and Read User Basic.

### Request syntax

```GENERIC
GET /api/admin/projects/{projectID}/team/users?{fields}&{$top}&{$skip}
```

|  null  |  The database ID of User  |
| --- | --- |

### Request parameters

|  Parameter  |  Type  |  Description  |
| --- | --- | --- |
|  fields  |  String  |  A list of User attributes that should be returned in the response. If no field is specified, only the `entityID` is returned.  |
|  $skip  |  Int  |  Optional. Lets you set a number of returned entities to skip before returning the first one.  |
|  $top  |  Int  |     Optional. Lets you specify the maximum number of entries that are returned in the response. If you don't set the $top value, the server limits the maximum number of returned entries.       The server returns a maximum of 42 entries for most resources that return collections. For more information, see [Pagination](api-concept-pagination.html).     |

### Sample

#### Sample request

```CURL
https://example.youtrack.cloud/api/admin/projects/0-6/team/users?fields=id,login
```

#### Sample response body

```JSON
[
  {
    "login": "jane.doe",
    "id": "1-2",
    "$type": "User"
  },
  {
    "login": "john.smith",
    "id": "1-3",
    "$type": "User"
  }
]
```