---
title: "List users by organization"
method: GET
path: "/organizations/{orgId}/users"
tags: ["organizations"]
---

# List users by organization

`GET /organizations/{orgId}/users`

Retrieve a list of users belonging to the specified organization. Only users within the organization can access the API.

## Path parameters

- `orgId` string, uuid, required

## Response `200`

Successfully list users by organization.

- ListUsersByOrganizationResponse
  - `users` UserInOrganization[] — A list of users in the specified organization.
    - `id` string, uuid, required — The user's ID.
    - `email` string, required — The user's email address.
    - `firstName` string, required — The user's first name.
    - `lastName` string, required — The user's last name.
    - `lastLoginAt` integer, required — The UNIX timestamp in seconds (UTC) of the user's most recent login. (UTC).
    - `lastLoginIDP` 'native' | 'google' | 'github' | 'hugging_face', required — The identity provider used during the user's most recent login. - "native": Logged in with username and password. - "google": Logged in using Google OAuth. - "github": Logged in using GitHub OAuth. - "hugging_face": Logged in using Hugging Face OAuth.
    - `orgRole` 'org_owner' | 'org_user', required — The user's organization role.

## Other responses

- `400` — - [group:**request**, code:**0**]: Invalid field in the request.
- `404` — - [group:**organization**, code:**2**]: Organization does not exist.
- `500` — - [group:**organization**, code:**1200**]: Get organization grouping policy encountered error. - [group:**organization**, code:**1201**]: Get organization encountered DB error. - [group:**user**, code:**1200**]: Get user encountered DB error.

---

[API](https://skmtc.net/gmicloud/apis/cluster-engine-api.md) · [All operations](https://skmtc.net/gmicloud/apis/cluster-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gmicloud/cluster-engine-api/versions/bcbab016469f/schema)