Load the current backend user
A server route needs the complete Clerk profile for a known authenticated user.
Clerk · Module
users.getUser
Retrieves a Clerk User by ID through the backend SDK. It returns a promise resolving to the user's Backend User object.
How it works
Call this backend SDK method with a Clerk user ID to asynchronously retrieve that user's full Backend User object. The method returns a promise and wraps Clerk's Backend API request for the individual user resource.
Syntax
function getUser(userId: string): Promise<User>Parameters
| Name | Type | Description |
|---|---|---|
userId | string | The ID of the user to retrieve. |
Returns
Promise<User> resolving to the requested User object.
Key points
- It retrieves one Clerk User resource identified by a user ID.
- The signature takes a string and resolves asynchronously to a User.
- The required argument is the ID of the user whose record should be loaded.
- The surrounding client-access syntax depends on which Clerk SDK integration is installed.
- The result is the backend representation of the user's Clerk account.
Common mistakes
- The call performs a Backend API request, so it should be used from a server-side context rather than exposed directly to an untrusted client.
- Frequent calls can be subject to rate limits; for frequently accessed metadata, consider putting it in the session token instead.
Example: Retrieve a user by ID
import { clerkClient } from '@clerk/express'
export async function getUserById(userId: string) {
return await clerkClient.users.getUser(userId)
}
Retrieves the Backend User object for the supplied Clerk user ID.
When to use it
Fetch a user by identifier
Backend code receives a Clerk user ID from trusted application context.
Read user metadata
A server needs public metadata stored on the Clerk User resource.
Interview questions
QWhat does users.getUser do?
getUser() accepts a single string, userId, and returns a Promise<User>. It retrieves the user identified by that ID through Clerk's Backend API.
Follow-up: How would you retrieve the authenticated user's record? Obtain the authenticated userId from the server-side auth context, then pass it to clerkClient.users.getUser(userId).
QWhat is the purpose of the userId parameter?
The method requires a Clerk user ID, not an email address or another profile field. The returned User object contains the retrieved user's backend data.
Follow-up: What should be used for searching multiple users? Use the user-list method rather than calling getUser() repeatedly, because this method targets one known ID.
QWhich API operation does the SDK method wrap?
getUser() is a wrapper around the Backend API endpoint GET/users/{user_id}. Using the SDK avoids manually constructing that request while preserving the endpoint's single-user semantics.
Follow-up: What operational concern applies to repeated calls? Backend API rate limits apply, so frequently needed metadata may be better attached to the session token.
Related
UserclerkClientusers.getUserList()currentUser()