> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tapti.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get User By ID

> Retrieves detailed information about a specific user by their unique identifier. This tool allows you to access user data, preferences, and settings for a single user in your application.

<Info>
  This tool is part of the [User Tools](./index) category.
</Info>

## Parameters

| Name     | Type   | Required | Description                    |
| -------- | ------ | -------- | ------------------------------ |
| user\_id | string | Yes      | The ID of the user to retrieve |

## Example Request

```json theme={null}
{
  "user_id": "user_12345"
}
```

## Example Response

```json theme={null}
{
  "id": "user_12345",
  "email": "user@example.com",
  "first_name": "John",
  "last_name": "Doe",
  "display_name": "John Doe",
  "preferences": {
    "notifications": {
      "email": true,
      "push": false
    },
    "theme": "light"
  },
  "metadata": {
    "company": "Example Corp",
    "role": "Content Creator"
  },
  "created_at": "2023-01-10T15:30:00.000Z",
  "updated_at": "2023-05-15T09:45:00.000Z"
}
```

## Usage Notes

* If the specified user does not exist, a `404 Not Found` error will be returned.
* User IDs are unique within your tenant application.
* The response includes basic user information such as email, name, and preferences.
* Additional user metadata may be included depending on your application's configuration.
* Use this method when you need detailed information about a specific user.
* For bulk operations, consider using [Get Users By Tenant App](./getUsersByTenantApp) instead.

## Related Tools

* [Get Users By Tenant App](./getUsersByTenantApp) - Get all users for your application
* [Get User Accounts](./getUserAccounts) - Get all accounts connected to a user
* [Create User](./createUser) - Create a new user in the system