---
title: "List Users and Groups with roles in an Organization"
method: GET
path: "/orgs/{orgId}/users"
tags: ["public", "UserRole"]
---

# List Users and Groups with roles in an Organization

`GET /orgs/{orgId}/users`

## Path parameters

- `orgId` string, required

## Query parameters

- `type` 'user' | 'group' — Subjects that can assume roles on objects.

## Response `200`

A list of Users and Groups and the roles they hold.

- UserRoleResponse[]
  - `created_at` string, required — The time the user or the group was first registered with Humanitec
  - `email` string — The email address of the user from the profile
  - `id` string, required — The User or Group Id
  - `invite` string — The status of an invitation (If applicable)
  - `name` string, required — The name the User or Group goes by
  - `role` string, required — The role that this User or Group holds
  - `type` string, required — The type of the account. Could be user, service, group or system
  - `idp_id` string — The IdP id the group is registered for. Empty if user is not a group.

## Other responses

- `403` — Server understands the request but refuses to authorize it.
- `404` — Either the resource or a related resource could not be found. More detail can be found in the error body.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)