---
title: "Get Unified Users"
method: GET
path: "/api/identity/{team_key}/users"
tags: ["identity"]
---

# Get Unified Users

`GET /api/identity/{team_key}/users`

## Request

- Base URL: `https://api.superit.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.superit.ai/api/identity/{team_key}/users`
- Auth: HTTP bearer

List internal users with M365/PSA match suggestions.

## Path parameters

- `team_key` string, required

## Query parameters

- `search` string
- `session` string
- `identity` string
- `ticketing` string
- `tags` string[]
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- UnifiedUsersListResponse: Paginated unified users list with match suggestions.
  - `count` integer, required
  - `page` integer, required
  - `pageSize` integer, required
  - `totalPages` integer, required
  - `stats` UnifiedStatsItem, required: Stats summary for unified users list page.
    - `total` integer, required
    - `unverifiedSessions` integer, required
    - `pendingActivation` integer, required
  - `connections` UnifiedConnectionItem[], required
    - `key` string, required
    - `displayName` string, required
    - `tenantId` string, required
    - `isActive` boolean, required
    - `lastSyncAt` string, nullable, required
  - `results` InternalUserItem[], required
    - `userId` integer, required
    - `userKey` string, required
    - `firstName` string, required
    - `lastName` string, required
    - `fullName` string: Person's full name; empty when unknown.
    - `nickname` string: Preferred name for conversation.
    - `displayName` string, required: Legacy conversational name; use fullName for administrative views.
    - `email` string, nullable, required: Internal login email, independent of the linked M365 mailbox and sign-in name.
    - `avatarUrl` string, nullable, required
    - `role` 'admin' | 'engineer' | 'user' | 'system' | 'inactive', required: Supported membership roles.
    - `lastLogin` string, nullable, required
    - `m365LinkedUserId` integer, nullable, required
    - `m365LinkedEmail` string, nullable, required: Legacy mail-or-UPN fallback; use m365LinkedAccount for explicit address roles.
    - `m365LinkedAccount` M365LinkedAccount: Directory account linked to a person; address roles remain distinct.
      - `m365UserId` integer, required
      - `displayName` string, required: Microsoft directory account label, including qualifiers.
      - `mail` string, nullable, required: Mailbox address from Microsoft; null when absent.
      - `userPrincipalName` string, required: Microsoft sign-in name (UPN), not necessarily a mailbox address.
    - `ticketingLinked` boolean, required
    - `ticketingLinkedEmail` string, nullable, required
    - `sessionStatus` 'verified' | 'unverified', required
    - `isStaff` boolean
    - `tags` string[]
  - `m365Matches` object, required
  - `psaMatches` object, nullable, required
  - `staffTeamName` string, nullable

## Other responses

- `400`: Invalid input
- `401`: Not authenticated
- `403`: Forbidden
- `404`: Not found
- `405`: Method not allowed
- `409`: Conflict
- `422`: Validation Error

---

[API](https://skmtc.dev/superit/apis/super-it-api.md) - [All operations](https://skmtc.dev/superit/apis/super-it-api/llms.txt) - [OpenAPI document](https://skmtc.dev/superit/apis/super-it-api/revisions/4944d556c2bb?raw)