API Reference

Login

Username + password login for an initialized session.

Endpoint

Method
POST
Path
/api/v2/login

Request Body

{
  "session_id": "dc1ce...a3a75",
  "username": "12",
  "password": "1",
  "sid": "S-1-5-21-....",
  "ip": "102.88.xxx.xxx"
}
  • session_id (required): from Init.
  • username (required)
  • password (required)
  • sid or hwid (required): system identifier.
  • ip (optional): client IP (server may also infer IP).

Success Response

{
  "success": true,
  "message": "Login success",
  "session_id": "dc1ce...a3a75",
  "user": {
    "username": "12",
    "email": null,
    "subscription": "Default",
    "subscription_level": 1,
    "expiry_date": "2026-04-29T07:07:00.000Z",
    "device_limit": 1,
    "current_devices": 1,
    "sid": "S-1-5-21-....",
    "hwid": "S-1-5-21-....",
    "last_login": "2026-04-13T12:00:00.000Z",
    "registered_at": "2026-03-26T12:29:48.697Z",
    "linked_license_key": "REGTEST"
  }
}

Error Codes

400
  • MISSING_FIELDS
401
  • INVALID_SESSION
  • SESSION_EXPIRED
  • INVALID_PASSWORD
403
  • IP_BLOCKED
  • VPN_BLOCKED
  • COUNTRY_BLOCKED
  • SID_BLOCKED
  • SID_NOT_WHITELISTED
  • USER_BANNED
  • USER_SUSPENDED
  • USER_EXPIRED
  • DEVICE_LIMIT_REACHED
404
  • USER_NOT_FOUND
500
  • INTERNAL