LioGames
Username API

API pencarian username game untuk platform reseller

Validasi player ID dan username yang didukung sebelum membuat pesanan top-up.

Nama endpoint teknis, key request, header autentikasi, dan field respons tetap menggunakan bahasa Inggris agar integrasi memakai satu kontrak API yang konsisten.

Username lookup API

Validate a supported player or character ID and retrieve the account username before placing a game top-up order.

POSThttps://distribution.liogames.com/api/v1/username-check

Plans & monthly quota

The Username API is billed by reseller level. The free browser-based Username Tools page is separate from the signed partner API quota.

GOLD500 / month

500 signed Username API requests are included each calendar month.

VIPUnlimited

Unlimited Username API access is included with VIP.

H2HUnlimited

Unlimited Username API access is included with H2H.

Quota response

{
  "ok": true,
  "found": true,
  "game": "MLBB",
  "username": "PLAYER_NAME",
  "quota": {
    "plan": "GOLD Free",
    "used": 24,
    "limit": 500,
    "remaining": 476,
    "reset_at": "..."
  }
}

HTTP response headers also expose X-LioGames-Username-Plan, X-LioGames-Username-Limit, X-LioGames-Username-Remaining and X-LioGames-Username-Reset.

Supported games

GamegameID fieldServer / zone
Mobile Legends: Bang Bang mobile-legends User ID String
8 Ball Pool 8-ball-pool Player ID Not required
Ace Racer ace-racer Player ID String
AFK Journey afk-journey Player ID Not required
Arena Breakout arena-breakout Player ID Not required
Arena Breakout: Infinite arena-breakout-infinite Player ID Not required
Brawl Stars brawl-stars Player Tag / ID Not required
Clash of Clans clash-of-clans Player Tag / ID Not required
Clash Royale clash-royale Player Tag Not required
Identity V identity-v Player ID String
Undawn undawn Player ID Not required
Wuthering Waves wuthering-waves Player ID Enum: os_sea = Southeast Asia, os_asia = Asia Pacific, os_usa = America, os_cht = China / Hong Kong / Taiwan, os_euro = Europe
Zepeto zepeto Zepeto ID Not required
Free Fire Global free-fire-global Player ID Not required
Honkai: Star Rail honkai-star-rail Player ID Enum: prod_official_usa = America, prod_official_asia = Asia, prod_official_eur = Europe, prod_official_cht = TW / HK / MO
Honor of Kings honor-of-kings Player ID Not required
Magic Chess: Go Go magic-chess-go-go User ID String
PUBG Mobile Global pubg-mobile-global Player ID Not required
PUBG Mobile Lite pubg-mobile-lite Player ID Not required
Stumble Guys stumble-guys Player ID Not required
Super Sus super-sus Player ID Not required
Yalla Ludo yalla-ludo Player ID Not required
Zenless Zone Zero zenless-zone-zero Player ID Enum: prod_gf_us = America, prod_gf_jp = Asia, prod_gf_eu = Europe, prod_gf_sg = TW / HK / MO
Jawaker jawaker Player ID Not required
Where Winds Meet where-winds-meet Character ID Fixed: -1 (Global)
Blood Strike blood-strike Player ID Fixed: -1 (Global)
Genshin Impact genshin-impact Player ID Enum: os_asia = Asia, os_usa = America, os_euro = Europe, os_cht = TW / HK / MO

Server & zone values

Use the exact values below. Values are case-sensitive. For fixed-zone games, clients may omit server_id; LioGames inserts -1 automatically.

GameTypeAccepted / documented values
Mobile Legends: Bang BangTextString
Ace RacerTextString
Identity VTextString
Wuthering WavesEnumEnum: os_sea = Southeast Asia, os_asia = Asia Pacific, os_usa = America, os_cht = China / Hong Kong / Taiwan, os_euro = Europe
Honkai: Star RailEnumEnum: prod_official_usa = America, prod_official_asia = Asia, prod_official_eur = Europe, prod_official_cht = TW / HK / MO
Magic Chess: Go GoTextString
Zenless Zone ZeroEnumEnum: prod_gf_us = America, prod_gf_jp = Asia, prod_gf_eu = Europe, prod_gf_sg = TW / HK / MO
Where Winds MeetFixedFixed: -1 (Global)
Blood StrikeFixedFixed: -1 (Global)
Genshin ImpactEnumEnum: os_asia = Asia, os_usa = America, os_euro = Europe, os_cht = TW / HK / MO

Authentication

Partner requests require member_code and x-liog-sign. Generate the signature from the exact raw JSON request body with your private Secret.

$rawJson = json_encode($payload, JSON_UNESCAPED_SLASHES);
$signature = hash_hmac('sha256', $rawJson, $secret);

Keep the Secret on your server. Do not place it in browser JavaScript, mobile apps or public repositories.

Request body

FieldRequiredDescription
member_codeYesYour LioGames Member ID.
gameYesStable game slug from the supported-games table.
user_idYesPlayer/User/Character ID for the selected game.
server_idConditionalServer or zone value when required. For Blood Strike and Where Winds Meet, it may be omitted because LioGames fixes it to -1.
{
  "member_code": "YOUR_MEMBER_CODE",
  "game": "mobile-legends",
  "user_id": "1393323764",
  "server_id": "15748"
}

Response

{
  "ok": true,
  "found": true,
  "game": "MLBB",
  "username": "PLAYER_NAME",
  "server_id": "15748"
}

Game-specific region or account-status fields are returned when available.

Request examples

Genshin Impact — Asia

{
  "member_code": "YOUR_MEMBER_CODE",
  "game": "genshin-impact",
  "user_id": "757141173",
  "server_id": "os_asia"
}

Honkai: Star Rail — America

{
  "member_code": "YOUR_MEMBER_CODE",
  "game": "honkai-star-rail",
  "user_id": "828132045",
  "server_id": "prod_official_usa"
}

Blood Strike — Global

{
  "member_code": "YOUR_MEMBER_CODE",
  "game": "blood-strike",
  "user_id": "827066497066"
}

LioGames sets server_id to -1 automatically for Blood Strike.

Where Winds Meet — Global

{
  "member_code": "YOUR_MEMBER_CODE",
  "game": "where-winds-meet",
  "user_id": "YOUR_CHARACTER_ID"
}

LioGames sets server_id to -1 automatically for Where Winds Meet.

Zenless Zone Zero — Europe

{
  "member_code": "YOUR_MEMBER_CODE",
  "game": "zenless-zone-zero",
  "user_id": "YOUR_PLAYER_ID",
  "server_id": "prod_gf_eu"
}

Usage

Username API responses include plan and quota information. Use these values to show the current monthly usage and remaining requests in your integration.