---
title: "List Users by Tenant"
method: GET
path: "/tenants/{tenant_id}/users"
tags: ["Identity"]
---

# List Users by Tenant

`GET /tenants/{tenant_id}/users`

List all users within a tenant.

## Path parameters

- `tenant_id` string, required

## Response `200`

Success

- UserTenantResponseList
  - `total_count` integer, required — Number of users in CoreStack account.
  - `users` UserTenantDetails[], 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
    - `roles` string[], required — List of role assignments for the user. The same user can be assigned with different roles in a tenant

## 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)