---
title: "Get Users for Organization"
method: GET
path: "/v1/organizations/{organizationId}/users"
tags: ["Organizations"]
---

# Get Users for Organization

`GET /v1/organizations/{organizationId}/users`

## Request

- Base URL: `https://api.tetrascience.com`
- URL: `https://api.tetrascience.com/v1/organizations/{organizationId}/users`
- Auth: API key in header `ts-auth-token` and API key in header `x-org-slug`

List all users within an organization including their roles, status, last activity, and access permissions for administrative oversight.

## Query parameters

- `userStatus` 'active' | 'inactive' | 'locked'
- `role` 'admin' | 'member' | 'readonly'
- `roleId` Id, required (unresolved $ref)
- `authType` 'password' | 'service'
- `from` number
- `size` number
- `email` Email (unresolved $ref)
- `firstName` string
- `lastName` string
- `include` string[]
- `withCredentials` boolean

## Parameters

- `#/paths/~1v1~1organizations~1{organizationId}/get/parameters/0` (unresolved $ref)

## Response `200`

Responding with list of users

- object[]
  - `authType` AuthType (unresolved $ref)
  - `email` Email (unresolved $ref)
  - `firstName` string
  - `lastName` string
  - `id` Id (unresolved $ref)
  - `lastActivity` string
  - `status` 'active' | 'inactive'
  - `systemRole` string
  - `roles` object[]
    - `id` Id (unresolved $ref)
    - `orgSlug` Schema (unresolved $ref)
    - `organizationId` Id (unresolved $ref)
    - `role` string
    - `roleId` Id (unresolved $ref)
    - `status` Status (unresolved $ref)
    - `userId` Id (unresolved $ref)
    - `orgName` string
  - `tokens` object[]
    - `id` Id (unresolved $ref)
    - `userId` Id (unresolved $ref)
    - `token` string: Truncated token value
    - `expiresAt` CreatedAt (unresolved $ref)
    - `createdAt` CreatedAt (unresolved $ref)
    - `createdBy` object
      - `id` Id (unresolved $ref)
      - `firstName` string, John
      - `lastName` string, Snow
  - `password_history` object[]
  - `athenaCredentialsUpdatedAt` CreatedAt (unresolved $ref)
  - `preferences` unknown[]
    - unknown
  - `rowPreferences` Preferences (unresolved $ref)

## Other responses

- `401`: Invalid token
- `403`: Caller is not authorized to perform this action

---

[API](https://skmtc.dev/tetrascience/apis/administration.md) - [All operations](https://skmtc.dev/tetrascience/apis/administration/llms.txt) - [OpenAPI document](https://skmtc.dev/tetrascience/apis/administration/revisions/c1c829febcc5?raw)