Skip to main content
The user endpoints let you look up public profile information for any Top.gg user by their Discord user ID. 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 Top.gg user associated with the given Discord user ID. 
curl -X GET https://top.gg/api/users/140862798832861184 \
  -H "Content-Type: application/json" \
  -H "Authorization: your-topgg-token"

​
Path parameters

​
user_id
string
required
The Discord Snowflake ID of the user to look up.

​
Response fields

​
id
string
required
The user’s Discord Snowflake ID.
​
username
string
required
The user’s Discord username.
​
discriminator
string
required
The user’s Discord discriminator (e.g., "0001").
​
avatar
string
The user’s Discord avatar hash. Absent if the user has no custom avatar.
​
defAvatar
string
required
The CDN hash for the user’s default (generated) avatar, used as a fallback when avatar is absent.
​
bio
string
The user’s Top.gg profile bio. Absent if not set.
​
banner
string
URL of the user’s profile banner image. Absent if not set.
​
social
object
required
An object containing the user’s linked social accounts. All sub-fields are optional and absent when not set.
​
color
string
The user’s custom profile color as a hex string (e.g., "#ff6347"). This value is user-supplied and is not guaranteed to be a valid hex color.
​
supporter
boolean
required
Whether the user is a Top.gg supporter.
​
certifiedDev
boolean
required
Whether the user is a Top.gg certified developer.
​
mod
boolean
required
Whether the user is a Top.gg moderator.
​
webMod
boolean
required
Whether the user is a Top.gg web moderator.
​
admin
boolean
required
Whether the user is a Top.gg administrator.

​
Example response

{
  "discriminator": "0001",
  "avatar": "a_1241439d430def25c100dd28add2d42f",
  "id": "140862798832861184",
  "username": "Xetera",
  "defAvatar": "322c936a8c8be1b803cd94861bdfa868",
  "admin": true,
  "webMod": true,
  "mod": true,
  "certifiedDev": false,
  "supporter": false,
  "social": {}
}
Returns 404 Not Found if no Top.gg profile exists for the given Discord user ID.