---
title: "Retrieve a user"
method: GET
path: "/users/{userId}"
tags: ["users"]
---

# Retrieve a user

`GET /users/{userId}`

## Path parameters

- `userId` string, required

## Response `200`

Returns the retrieved user.

- UserOutput
  - `data` object, required
    - `email` string, required — The email address of the user, this must be unique.
    - `password` string — The password of the user if using password based login - this will never be returned. This can be left out of subsequent requests (updates) and will be enriched back into the user structure.
    - `status` 'active' — The status of the user, if they are active.
    - `firstName` string — The first name of the user
    - `lastName` string — The last name of the user
    - `forceResetPassword` boolean — If set to true forces the user to reset their password on first login.
    - `builder` object — Describes if the user is a builder user or not. This field can only be set on a business or enterprise license.
      - `global` boolean — If set to true the user will be able to build any app in the system.
    - `admin` object — Describes if the user is an admin user or not. This field can only be set on a business or enterprise license.
      - `global` boolean — If set to true the user will be able to administrate the system.
    - `roles` object — Contains the roles of the user per app (assuming they are not a builder user). This field can only be set on a business or enterprise license.
    - `_id` string, required — The ID of the user.

---

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