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

# List users

`GET /users`

Retrieves a collection of all users for a team or an organization with a given ID. Returned users are sorted by id in descending order.

## Query parameters

- `organizationId` integer
- `teamId` integer
- `name` string
- `email` string
- `teamRoleId` integer
- `organizationRoleId` integer
- `filterByTeamId` integer
- `ids` integer[]
- `tfaStatus` 0 | 1 | 2
- `cols[]` string[]
- `pg[sortBy]` 'name' | 'id' | 'email'
- `pg[sortDir]` 'asc' | 'desc'
- `pg[offset]` integer
- `pg[limit]` integer

## Response `200`

Successful response

- object
  - `users` object[]
    - `id` integer
    - `name` string
    - `email` string, email
    - `language` string
    - `timezoneId` integer
    - `localeId` integer
    - `countryId` integer
    - `features` object
      - `allow_apps` boolean
    - `avatar` string, uri
    - `lastLogin` string, date-time
    - `tfaStatus` 0 | 1 | 2, nullable — Two-factor authentication status: - 0: No TFA set - 1: TFA active (authenticator app) - 2: External authentication (Social SSO) It is only supported on Make's public cloud instances.
    - `supportEligible` boolean — Whether the user is eligible for contact support. False if all user's organizations are on Free plan and account is older than 90 days.
    - `userTeamIds` integer[], nullable — IDs of teams the user belongs to within the organization. Only returned when explicitly requested via cols[]=userTeamIds and organizationId is provided.
    - `privateSpace` object, nullable — The user's personal private space in the organization. Only returned when explicitly requested via cols[]=privateSpace with organizationId on a public instance.
      - `id` integer
      - `name` string
      - `globalAgentsEnabled` boolean
      - `type` 'personal'
      - `operationsLimit` integer, nullable
      - `transferLimit` unknown
      - `consumedOperations` integer, nullable
      - `consumedTransfer` unknown
      - `isPaused` boolean, nullable
      - `consumedCenticredits` integer, nullable
  - `pg` object
    - `last` string — Shown only when using the `last` based pagination.
    - `showLast` boolean — Shown only when using the `last` based pagination.
    - `sortBy` string
    - `sortDir` string
    - `limit` integer
    - `offset` integer — Shown only when using the `offset` based pagination.

---

[API](https://skmtc.dev/make/apis/web-api-v2-public.md) · [All operations](https://skmtc.dev/make/apis/web-api-v2-public/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/make/web-api-v2-public/revisions/531769e6f813/schema)