Skip to main content
GET
/
v1
/
bot
/
users
/
{user_id}
curl https://portal-api.7331.org/v1/bot/users/42 \
  -H "X-API-Key: your-bot-api-key"
{
  "id": 42,
  "username": "exampleuser",
  "subscription_tier": 0,
  "permission_level": 0,
  "state": 0,
  "created_at": "2025-01-01T00:00:00Z",
  "updated_at": "2025-01-15T12:00:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.7331.org/llms.txt

Use this file to discover all available pages before exploring further.

user_id
integer
required
Entity ID.
X-API-Key
string
required
Bot API key.

Response

Returns a UserBotResponse — a restricted subset of user data available to bot-authenticated callers. Includes public fields plus permission_level, state, created_at, and updated_at, but excludes subscription details.
id
integer
required
Entity ID.
username
string
Username.
subscription_tier
integer
Current subscription level. 0 = Basic, 1 = Trial, 2 = Premium, 3 = Lifetime.
permission_level
integer
Permission level. 0 = User, 1 = Moderator, 2 = Admin, 3 = Owner.
state
integer
required
User state. 0 = Active, 1 = Timeout, 2 = Banned.
created_at
string
required
When the user was created (UTC).
updated_at
string
required
When the user was last updated (UTC).
curl https://portal-api.7331.org/v1/bot/users/42 \
  -H "X-API-Key: your-bot-api-key"
{
  "id": 42,
  "username": "exampleuser",
  "subscription_tier": 0,
  "permission_level": 0,
  "state": 0,
  "created_at": "2025-01-01T00:00:00Z",
  "updated_at": "2025-01-15T12:00:00Z"
}