---
title: "List users"
method: GET
path: "/api/Users"
tags: ["Users"]
---

# List users

`GET /api/Users`

Returns all users in your organization. Users with 'Manage Users and Groups' permission receive additional account metadata. Pass includeDeleted=true (requires 'Manage Users and Groups') to also include soft-deleted users.
### Required Permissions

- **Global:** View Users And Groups

## Query parameters

- `includeDeleted` boolean

## Response `200`

Returns organization users

- EnrichedUserEntityModel[]
  - `id` string, required — The unique identifier of the user or group.
  - `userName` string, nullable, required — The display name of the user or group.
  - `firstName` string, nullable — The user's first name.
  - `lastName` string, nullable — The user's last name.
  - `organizationId` string, nullable — The identifier of the organization the user belongs to.
  - `photoMetadata` UserPhotoModel — Metadata about a user's profile photo.
    - `name` string, required — The file name of the photo.
    - `url` string, nullable — The URL where the photo can be accessed, if available.
    - `fileType` string, nullable — The MIME type of the photo (e.g. image/png).
    - `content` string, byte, nullable — The raw byte content of the photo, if loaded.
    - `isManualUpload` boolean — Whether the photo was manually uploaded by the user (as opposed to sourced from SSO).
  - `accountMetadata` UserEntityMetadata — Account-level metadata for a user, including creation and activity timestamps.
    - `createdAt` Instant — A point in time represented as an ISO 8601 timestamp string.
    - `lastActivityDate` Instant — A point in time represented as an ISO 8601 timestamp string.
  - `teamName` string, nullable — The name of the team the user belongs to, if set.
  - `deleted` boolean — Whether the user has been soft-deleted. Only surfaced to callers with permission to manage users.

---

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