---
title: "List organization users"
method: GET
path: "/internal/v1/orgs/{org_id}/users"
tags: ["Users"]
---

# List organization users

`GET /internal/v1/orgs/{org_id}/users`

List all users that belong to an organization.

## Path parameters

- `org_id` integer, required

## Query parameters

- `email` string

## Response `200`

Users listed.

- OrgUserListResponse
  - `users` OrgUserDetail[], required
    - `id` integer, required
    - `orgId` integer, required
    - `userId` integer, required
    - `providerId` integer — SSO provider ID if the membership was auto-provisioned via OIDC/SAML. Zero for memberships created directly or via invitation acceptance.
    - `role` 'owner' | 'admin' | 'member' | 'viewer' | 'billing_manager' | 'collaborator', required — A user's role within an organization.
    - `updatedAt` number — Unix timestamp in nanoseconds.
    - `name` string, required
    - `email` string, required
    - `avatar` string — URL to the user's avatar image.
    - `mfaEnabled` boolean — Whether the user has two-factor authentication enabled.
    - `providerDomain` string — SSO provider domain if the membership was auto-provisioned. Empty otherwise.
    - `numProject` integer — Number of projects the user has access to within this organization.
    - `numTeam` integer — Number of teams the user belongs to within this organization.

## Other responses

- `401` — Authentication required
- `500` — Internal server error

---

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