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

# List Users

`GET /user`

## Request

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

## Response `200`

200

- object
  - `users` User[]
    - `sso` boolean: SSO enabled
    - `two-factor-authentication` boolean: Two Factor Authentication enabled
    - `email` string, required: User Email
    - `id` string, uuid: User ID
    - `role` IamRole, required: IAM Role
      - `description` string: IAM Role description
      - `labels` Labels
      - `permissions` string[]: IAM Role permissions
      - `assume-role-policy` IamAssumeRolePolicy: Assume Role Policy
        - `rules` IamServicePolicyRule[]: IAM Assume Role Policy rules
          - `action` 'allow' | 'deny'
          - `expression` string
          - `resources` string[]
      - `editable` boolean: IAM Role mutability
      - `name` string: IAM Role name
      - `max-session-ttl` integer: Maximum TTL requester is allowed to ask for when assuming a role
      - `policy` IamPolicy: Policy
        - `default-service-strategy` 'allow' | 'deny', required: IAM default service strategy
        - `services` object, required: IAM services
      - `id` string, uuid: IAM Role ID
    - `pending` boolean: True if the user has not yet created an Exoscale account

---

[API](https://skmtc.dev/exoscale/apis/exoscale-api.md) - [All operations](https://skmtc.dev/exoscale/apis/exoscale-api/llms.txt) - [OpenAPI document](https://skmtc.dev/exoscale/apis/exoscale-api/revisions/63da6f74c845?raw)
