Skip to main content
GET
Get User
Retrieves the full details of a user by their Clerk user ID. This endpoint returns user profile information including contact details, profile picture, and metadata.
User management (creation, updates, deletion) is handled directly through Clerk. This endpoint provides read-only access to user data.

Authentication

This endpoint requires authentication. The user must be signed in.

Request

string
required
The Clerk user ID of the user to retrieve (e.g., user_abc123).

Response

Returns the complete Clerk user object.
string
required
Unique Clerk user identifier.
string | null
required
The user’s first name. May be null if not set.
string | null
required
The user’s last name. May be null if not set.
string | null
required
The user’s username. May be null if not set.
string | null
required
ID of the user’s primary email address.
object | null
The user’s primary email address object.
array
required
Array of all email addresses associated with this user.
string | null
required
ID of the user’s primary phone number. May be null if not set.
array
required
Array of all phone numbers associated with this user.
string
required
URL to the user’s profile image.
boolean
required
Whether the user has uploaded a custom profile image.
string | null
required
External identifier for the user if set. May be null.
object
required
Public metadata object for the user. Accessible from frontend.
object
required
Private metadata object for the user. Only accessible from backend.
object
required
Unsafe metadata object that can be modified from frontend.
number
required
Unix timestamp (milliseconds) of when the user was created.
number
required
Unix timestamp (milliseconds) of when the user was last updated.
number | null
required
Unix timestamp (milliseconds) of the user’s last sign-in. May be null if never signed in.
boolean
required
Whether the user has two-factor authentication enabled.
boolean
required
Whether the user is banned from the organization.
boolean
required
Whether the user account is locked.

Response Examples

Error Codes