Skip to main content
Fetch User by Username
Finds a user within the project by their username. Optionally includes file associations for avatar and banner images.
If the profile owner has blocked the signed-in caller, this returns 404 — the same response as a user who does not exist. The reverse is not true: a user you have blocked stays visible, so you keep a way to find and unblock them. Requires the moderation bundle.

Query Parameters

string
required
The username to look up. Lookup is exact-match and case-sensitive to the stored value (usernames are lowercased on write).
string
Comma-separated list of associations to include. Pass "files" to include the processed avatarFile and bannerFile objects.

Space-scoped reputation

This endpoint has no space in context, so the opt-in spaceReputation object accepts a spaceId of a space <uuid> or none only — context is rejected (400). It adds a spaceReputation field to each returned user, alongside the always-present reputation total. Requires the reputation bundle. See the Reputation data model.

Response

On success, returns HTTP 200 with the user object:
string
Unique user ID (UUID).
string | null
External identifier from your system.
string
Project this user belongs to.
string | null
Display name.
string | null
The user’s username.
string | null
Avatar image URL.
string | null
Short bio text.
object | null
Public custom key-value data.
number
Reputation score.
object | null
Processed avatar image with variants. Only present when include=files is requested.
object | null
Processed banner image with variants. Only present when include=files is requested.
string
ISO timestamp of account creation.

Error Responses

See Also