Fetch User
User Endpoints
Fetch User
Get a user’s public profile by ID
GET
Fetch User
Returns a user’s public profile by their Sublay user ID. Optionally includes associated file records for the avatar and banner.
Path Parameters
The Sublay user ID (UUID).
Query Parameters
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-inspaceReputation 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 HTTP200 with the user object:
Unique user ID (UUID).
External identifier linking this user to your system.
Project this user belongs to.
Display name.
Unique username within the project.
Avatar image URL.
Short bio text.
Public custom key-value data.
The user’s overall reputation total (the sum of all their reputation buckets).
This is a global lookup with no space in context, so it returns the total only —
see Reputation for space-scoped reads.
Processed avatar image with variants. Only present when
include=files is
requested.Processed banner image with variants. Only present when
include=files is
requested.ISO timestamp of account creation.
Error Responses
User Not Found — 404
User Not Found — 404
Invalid Params — 400
Invalid Params — 400

