---
title: "List users"
method: GET
path: "/2/accounts/{account}/users"
tags: ["User Management > Accounts"]
---

# List users

`GET /2/accounts/{account}/users`

This endpoint allows you to retrieve all users of a single Account specified by the requested unique identifier.

## Path parameters

- `account` integer, required

## Query parameters

- `with` string
- `filter` object
  - `drive_id` integer
  - `has_billing_access` boolean
  - `has_empty_access` boolean
  - `has_kchat` boolean
  - `has_ksuite` boolean
  - `has_no_app_access` boolean
  - `has_otp` boolean
  - `invitation_status` string
  - `mail_ids` integer[]
  - `role_type` string
  - `state_in_account` 'pending' | 'valid'
  - `team_ids` integer[]
  - `user_ids` integer[]
- `order_by` unknown[]
  - unknown
- `order_for` unknown[]
  - unknown
- `search` string
- `return` 'total'
- `page` integer
- `per_page` integer
- `order_by` union
  - string
  - string[]
- `order` 'asc' | 'desc'
- `order_for` object

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 087adaadUserorpendinguser
    - `user_id` integer, nullable, required
    - `invitation_id` integer, nullable, required
    - `first_name` string, required — First name
    - `last_name` string, required — Last name
    - `display_name` string, required — Display name
    - `email` string, required — Email
    - `avatar` string, nullable, required — null is returned only when request parameter no_avatar_default=1 and the user has not set an avatar
    - `role_type` string, required
    - `state_in_account` string, required
    - `is_correspondent` boolean, nullable, required
    - `is_correspondent_billing` boolean, nullable, required
    - `is_workspace_only` boolean, nullable, required
    - `has_no_manager_access` boolean, nullable, required
    - `has_billing_access` boolean, nullable, required
    - `is_sso` boolean, required
    - `language_id` integer, nullable, required — Unique identifier of the `language` that is related to the resource `User or pending user`
    - `app_access` string
    - `teams` string
    - `drive_infos` string
    - `kchat_infos` string
    - `unique_key` string, required
    - `last_login_at` integer, required — Timestamp `User or pending user` has been logged
    - `security` string
    - `pending_invitations` string
    - `preferences` string
    - `invitation_details` string, nullable
    - `service_permissions` string
    - `permissions` string
    - `partnership_id` integer, nullable, required
  - `total` integer — Total number of items Added when using query parameter `page`
  - `page` integer — Number of the current page Added when using query parameter `page`
  - `pages` integer — Total number of pages Added when using query parameter `page`
  - `items_per_page` integer — Number of items per page Added when using query parameter `page`

## Other responses

- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)