Game Username API Documentation

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.

GOLD Unlimited$3 / month

Optional unlimited Username API membership, charged from the LioGames USD wallet.

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

Game	`game`	ID field	Server / 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.

Game	Type	Accepted / documented values
Mobile Legends: Bang Bang	Text	String
Ace Racer	Text	String
Identity V	Text	String
Wuthering Waves	Enum	Enum: os_sea = Southeast Asia, os_asia = Asia Pacific, os_usa = America, os_cht = China / Hong Kong / Taiwan, os_euro = Europe
Honkai: Star Rail	Enum	Enum: prod_official_usa = America, prod_official_asia = Asia, prod_official_eur = Europe, prod_official_cht = TW / HK / MO
Magic Chess: Go Go	Text	String
Zenless Zone Zero	Enum	Enum: prod_gf_us = America, prod_gf_jp = Asia, prod_gf_eu = Europe, prod_gf_sg = TW / HK / MO
Where Winds Meet	Fixed	Fixed: -1 (Global)
Blood Strike	Fixed	Fixed: -1 (Global)
Genshin Impact	Enum	Enum: 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

Field	Required	Description
`member_code`	Yes	Your LioGames Member ID.
`game`	Yes	Stable game slug from the supported-games table.
`user_id`	Yes	Player/User/Character ID for the selected game.
`server_id`	Conditional	Server 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.

Game Username Lookup API for reseller platforms