---
title: "List Users"
method: GET
path: "/users"
tags: ["Users"]
---

# List Users

`GET /users`

## Request

- Base URL: `https://api.crowdin.com/api/v2`
- URL: `https://api.crowdin.com/api/v2/users`
- Auth: none declared
- TypeScript: <https://skmtc.dev/crowdin/apis/crowdin-enterprise-api-v2/docs/users/get.ts> (a function with typed inputs; its response is checked against the schema)

**Required scopes:** `user` (Read only).

## Query parameters

- `orderBy` 'id' | 'username' | 'firstName' | 'lastName' | 'email' | 'status' | 'createdAt' | 'lastSeen'
- `status` 'active' | 'pending' | 'blocked'
- `search` string
- `twoFactor` 'enabled' | 'disabled'
- `organizationRoles` string
- `teamId` integer
- `projectIds` string
- `projectRoles` string
- `languageIds` string
- `groupIds` string
- `lastSeenFrom` string
- `lastSeenTo` string
- `limit` integer
- `offset` integer

## Response `200`

Users list

- UserCollectionResource: Base schema of resource container. Container is a wrapper object that contains payload in required `data` property and provides space for adding any other metadata.
  - `data` UserResource[], required
    - `data` EnterpriseUserAdminContextResponseModel, required
      - `id` integer: User Identifier
      - `username` string
      - `firstName` string, nullable: First Name
      - `lastName` string, nullable: Last Name
      - `avatarUrl` string: User Avatar
      - `fields` EnterpriseAdditionalFields: Fields. Keys get via [List Fields](#operation/api.fields.getMany)
      - `isAdmin` boolean
      - `status` 'active' | 'pending' | 'blocked': User Status
      - `createdAt` string, date-time
      - `lastSeen` string, date-time, nullable
      - `email` string
      - `emailVerified` boolean
      - `twoFactor` 'enabled' | 'disabled'
      - `timezone` string, nullable
      - `joinDetails` object, nullable
        - `type` string
        - `invitedBy` object, nullable
          - `id` integer
          - `username` string
          - `fullName` string
          - `avatarUrl` string
      - `deviceVerification` 'enabled' | 'disabled'
      - `trustedDevicesCount` integer
      - `apiTokensCount` integer
      - `loginMethods` string[]
      - `mfaMethods` string[]
  - `pagination` Pagination: Pagination Response Model
    - `offset` integer
    - `limit` integer

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/crowdin/apis/crowdin-enterprise-api-v2.md) - [All operations](https://skmtc.dev/crowdin/apis/crowdin-enterprise-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/crowdin/apis/crowdin-enterprise-api-v2/revisions/dc68744c5384?raw)