---
title: "Get User"
method: GET
path: "/v1/users/{user_id}"
tags: ["v1", "Users"]
---

# Get User

`GET /v1/users/{user_id}`

## Query parameters

- `underprovision` boolean

## Response `200`

Success

- NoSecretUser
  - `id` union, required — User ID
    - string, uuid
    - string
  - `email` string, required — User email
  - `createdAt` string, date-time, required — User created at
  - `updatedAt` string, date-time, required — User updated at
  - `isAdmin` boolean, required — Is the user an admin
  - `api_key` ApiKey, required
    - `user_id` union, required — User ID
      - string, uuid
      - string
    - `api_key` string, required — User's API key
    - `created_at` string, date-time, required — API key created at
    - `updated_at` string, date-time, required — API key updated at
  - `teams` NoSecretTeam[], required — Teams the user is a member of
    - `id` union, required — Team ID
      - string, uuid
      - string
    - `domain` string, required — Domain from team email
    - `details` TeamDetailsSchema
      - `onboarding` TeamDetailsOnboardingSchema
        - `has_added_doc` boolean
        - `has_added_integration` boolean
        - `has_added_team_member` boolean
      - `timezone` string — Team timezone for date calculations (e.g. America/New_York)
      - `ssoEnabled` boolean — Whether SSO is enabled for the team
      - `ssoRequired` boolean — Whether SSO is required for the team
    - `members` TeamMember[], required — Team members
      - `id` union, required — User ID
        - string, uuid
        - string
      - `email` string, required — User email
      - `role` Role, required
        - `id` union, required — Role ID
          - 1 | 2 | 3 | 4 | 5
          - 1 | 2 | 3 | 4 | 5 — Enum for team roles. Can be used interchangeably with TeamRoleId.
        - `name` 'guest' | 'viewer' | 'analyst' | 'admin' | 'embedded_viewer', required — User email
        - `permissions` string[], required — Permissions the role has
      - `inviteStatus` 'active' | 'pending', nullable — 'pending' if the user has been invited but never signed in, 'active' otherwise.
      - `lastSignInAt` string, date-time, nullable — Timestamp of the user's most recent sign-in
    - `created_at` string, date-time, required — Timestamp when team was created
    - `updated_at` string, date-time, required — Timestamp when team was updated
    - `plan` 'free' | 'trial' | 'standard' | 'enterprise', required — Team plan
    - `trial_end_at` string, date-time, nullable — Trial end timestamp

## Other responses

- `404` — User Not Found
- `422` — Validation Error

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/3943d8deb3be/schema)