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

# List Users

`GET /users`

Returns a list of users, you can also filter by id, email and teamUUID

## Query parameters

- `filter[id]` string[]
- `filter[email]` string[]
- `teamUUID` string
- `includeDeleted` boolean

## Response `200`

users successfully returned

- ListUsersResponse
  - `data` User[]
    - `uuid` string — The unique identifier of the user.
    - `email` string — The email address of the user.
    - `firstName` string — The first name of the user.
    - `lastName` string — The last name of the user.
    - `createdAt` string — The date and time the user was created.
    - `deletedAt` string — The date and time the user was deactivated.
    - `transcriptLang` string — The preferred transcript language for the user.
    - `joinOutsideHostMeetings` boolean — Indicates if the user can join meetings outside their host organization.
    - `realTimeCapabilities` boolean — Indicates if the user has real-time transcription capabilities.
    - `settings` UserSettings
      - `realTimeCapabilitiesOFF` boolean
      - `autoCalculateCRMFields` boolean
      - `joinWhenIAmHostAndAlone` boolean
      - `joinWhenIAmHostWithPeers` boolean
      - `joinWhenPeerIsHost` boolean
      - `joinWhenUnlicensedPeerIsHost` boolean
      - `dealsEnabled` boolean
    - `botName` string — The name of the bot associated with the user.
    - `botImageURL` string — The URL of the bot's profile image.
    - `primaryTeamUUID` string — The UUID of the user's primary team.
    - `organizationRoleUUID` string — The UUID of the user's role in the organization.
    - `roles` Role[] — A list of roles assigned to the user.
      - `uuid` string
      - `name` string
      - `type` string
    - `showReferralScreen` boolean — Whether the user is shown a referral screen.
    - `seatType` string — The type of seat assigned to the user.
    - `teams` Team[] — A list of teams assigned to the user.
      - `uuid` string — Unique identifier of the team
      - `name` string — Name of the team
      - `phrases` string[] — List of keywords or phrases associated with the team
      - `slackConnection` SlackConnection — Represents the Slack integration details for a team
        - `id` string — Slack connection identifier
        - `info` SlackTeamInfo — Information about a connected Slack team
          - `id` string — Slack team identifier
          - `name` string — Name of the Slack team
      - `domain` string — Domain associated with the team
      - `organizerJoinInternalMeetings` boolean — Whether team organizers can join internal meetings
      - `consentEmailEnabled` boolean — Whether email consent is enabled for the team
      - `parentTeamUUID` string — UUID of the parent team if this team is part of a hierarchy
      - `organizationUUID` string — UUID of the organization this team belongs to
      - `children` Team[] — List of child teams if this team has a hierarchical structure
  - `links` Links
    - `self` string
    - `related` string

## Other responses

- `401` — valid API key required
- `default` — unexpected error

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/versions/5de55d3804cf/schema)