Skip to main content
GET
/
api
/
v2
/
user
/
me
Get Current User
curl --request GET \
  --url https://api.example.com/api/v2/user/me \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "avatar_url": "<string>"
}
'
{
  "id": 123,
  "name": "<string>",
  "email": {},
  "telegram_username": {},
  "avatar_url": {},
  "plan": "<string>",
  "plan_expires_at": {},
  "token_balance": 123,
  "token_limit": 123,
  "rate_limit_hourly": 123,
  "rate_limit_daily": 123,
  "auth_methods": {}
}

​
Request

curl https://neuralbox.top/api/v2/user/me \
  -H "Authorization: Bearer nb_YOUR_API_KEY"

​
Response

​
id
integer
Internal user ID.
​
name
string
Display name.
​
email
string | null
Email address (null if registered via Telegram only).
​
telegram_username
string | null
Telegram username (null if registered via email/Google).
​
avatar_url
string | null
Profile picture URL.
​
plan
string
Active subscription plan: free (Starter) | basic | pro | vip | elite
​
plan_expires_at
string | null
ISO 8601 datetime when the current subscription expires. Null for Starter plan.
​
token_balance
integer
Current token balance (subscription tokens + bonus tokens combined).
​
token_limit
integer
Monthly token allowance for your plan.
​
rate_limit_hourly
integer
Max requests per hour. 0 = unlimited (Elite plan).
​
rate_limit_daily
integer
Max requests per day. 0 = unlimited (Elite plan).
​
auth_methods
object
Which authentication methods are connected to this account.

​
Response Example

{
  "id": 1042,
  "name": "Ivan Petrov",
  "email": "ivan@example.com",
  "telegram_username": "ivan_dev",
  "avatar_url": "https://t.me/i/userpic/320/ivan_dev.jpg",
  "plan": "vip",
  "plan_expires_at": "2026-04-08T00:00:00Z",
  "token_balance": 1247,
  "token_limit": 1500,
  "tokens_used_this_period": 253,
  "rate_limit_hourly": 100,
  "rate_limit_daily": 1000,
  "auth_methods": {
    "telegram": true,
    "google": false,
    "email": true
  }
}

​
Get Balance

Lightweight endpoint for just token balance info. 
curl https://neuralbox.top/api/v2/user/balance \
  -H "Authorization: Bearer nb_YOUR_API_KEY"

{
  "plan": "vip",
  "token_balance": 1247,
  "plan_tokens_remaining": 1247,
  "bonus_tokens": 0,
  "plan_expires_at": "2026-04-08T00:00:00Z",
  "next_refill_at": "2026-04-08T00:00:00Z"
}

​
Update Profile

Update your display name or avatar. 
curl -X PATCH https://neuralbox.top/api/v2/user/me \
  -H "Authorization: Bearer nb_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ivan P."
  }'

​
Request Body

​
name
string
New display name.
​
avatar_url
string
New avatar URL.
Returns the updated user object.