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

# List Users

`GET /users/list`

List all users within a CoreStack account.

## Query parameters

- `master_account_id` string

## Response `200`

Success

- UserResponseList
  - `total_count` integer, required — Number of users in CoreStack account.
  - `users` UserDetails[], required — List all users within a CoreStack account.
    - `user_id` string, required — ID of the User. This is an auto generated and unique in the CoreStack system
    - `username` string, required — Username is unique in the CoreStack system. User can use this to login to CoreStack portal in addition to email
    - `status` string, required — Current Status of the user - active or inactive. Inactive user cannot login or use AccessKeys
    - `email` string, required — Email of the User. This is unique in the CoreStack system
    - `role_assignment` RoleAssignment[], required — List of roles assignments or the user. The same user can be assigned different roles in different tenants
      - `tenant_name` string, required — Name of the tenant within the CoreStack account
      - `tenant_id` string, required — ID of the tenant within the CoreStack account
      - `roles` RoleAssignmentRole[], required — List of roles for this tenant. User can have multiple roles within a tenant
        - `name` string, required — Name of the Role assigned to the user under a tenant
        - `id` string, required — ID of the Role assigned to the user under a tenant
    - `timezone_id` string, required — Id of the Timezone such as Asia/Kolkata, Asia/Dubai and so on
    - `source_user_id` string — source user id

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/corestack/apis/corestack-external-api.md) · [All operations](https://skmtc.dev/corestack/apis/corestack-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corestack/corestack-external-api/revisions/bf2cdf20826d/schema)