Skip to main content
GET
/
v1
/
users
/
{user_id}
curl https://hapi.7331.org/v1/users/123456789012345678 \
  -H "X-API-Key: $API_KEY"

{
  "discord_id": "123456789012345678",
  "username": "exampleuser",
  "avatar_url": "https://cdn.discordapp.com/avatars/123456789012345678/abc.png",
  "subscription_tier": 0,
  "source": "database",
  "created_at": "2025-01-01T00:00:00Z",
  "updated_at": "2025-01-15T12:00:00Z"
}
Public access returns basic profile data. Privileged viewers (moderators and above) who can act on the target user see an enriched response with punishments, guilds, bots, login history, and subscription history.
​
user_id
integer
required
Discord snowflake ID.
​
X-API-Key
string
Public API key (required for unauthenticated access).

​
Response

​
Public (unauthenticated or insufficient permissions)

​
discord_id
string
required
Discord user ID.
​
username
string
Discord username.
​
avatar_url
string
Discord CDN avatar URL.
​
subscription_tier
integer
Current subscription level. 0 = Basic, 1 = Trial, 2 = Premium, 3 = Lifetime.
​
created_at
string
required
When the user was created (UTC).
​
updated_at
string
required
When the user was last updated (UTC).

​
Elevated (moderator+ with hierarchy access)

All public fields plus:
​
state
integer
User state. 0 = Active, 1 = Timeout, 2 = Banned.
​
permission_level
integer
Permission level. 0 = User, 1 = Moderator, 2 = Admin, 3 = Owner.
​
login_history
object
Login history grouped by IP address.
​
punishments
object[]
Punishment history.
​
guilds
object[]
Guilds owned by this user.
​
bots
object[]
Bots owned by this user.
​
subscription_history
object[]
Subscription tier change history (admin+ only).
curl https://hapi.7331.org/v1/users/123456789012345678 \
  -H "X-API-Key: $API_KEY"

{
  "discord_id": "123456789012345678",
  "username": "exampleuser",
  "avatar_url": "https://cdn.discordapp.com/avatars/123456789012345678/abc.png",
  "subscription_tier": 0,
  "source": "database",
  "created_at": "2025-01-01T00:00:00Z",
  "updated_at": "2025-01-15T12:00:00Z"
}