User Endpoints — FBL v1 API

Fetch an FBL user's public profile by their profile id, including social links, roles, and avatar using the `GET /users/:user_id` endpoint.

The user endpoint lets you look up public profile information for any FBL user by their profile UUID. This is useful for displaying voter profiles, verifying user roles, or surfacing social links within your own application.

GET /users/:user_id

Returns public profile data for the FBL user associated with the given profile id.

curl https://fbl.gg/api/v1/users/88888888-8888-8888-8888-888888888888

Auth: public. Rate-limited per IP.

Path parameters

user_id string required

The FBL profile UUID of the user to look up.

Response fields

id string required

The user's FBL profile UUID.

username string required

The user's FBL username. Unique and lowercase.

display_name string?

The user's chosen presentation name. May be null.

avatar string?

Full CDN URL of the user's avatar. Absent if the user has no custom avatar.

banner string?

URL of the user's profile banner image. null if not set.

bio string?

The user's Markdown-safe short bio. null if not set.

pronouns string?

Free-form pronouns, e.g. "she/her". null if not set.

fluxer_id string?

The user's linked Fluxer snowflake id. null if the account isn't linked.

socials object[] required

Array of { type, url } entries for the user's linked social accounts. Empty array when no socials are set.

admin boolean required

Whether the user is an FBL administrator.

mod boolean required

Whether the user is an FBL moderator.

supporter boolean required

Reserved for the future FBL supporter tier. Always false today.

certified boolean required

Reserved for the future certified-developer flag. Always false today.

created_at string required

ISO 8601 date the profile was created.

Example response

{
  "id": "88888888-8888-8888-8888-888888888888",
  "username": "ariz",
  "display_name": "Ariz",
  "avatar": "https://fluxerusercontent.com/avatars/.../a.png",
  "banner": null,
  "bio": "Building FBL.",
  "pronouns": "he/him",
  "fluxer_id": "1493230087487714059",
  "socials": [
    { "type": "twitter", "url": "https://twitter.com/ariz" },
    { "type": "github",  "url": "https://github.com/ariz" }
  ],
  "admin": false,
  "mod": false,
  "supporter": false,
  "certified": false,
  "created_at": "2025-09-02T14:03:22.000Z"
}

Returns 404 Not Found if no FBL profile exists for the given id:

{ "error": { "code": "not_found", "message": "User not found" } }

Bots