Look up a Mobile Legends: Bang Bang account by user ID and server (zone).
Game ID Checker API Docs
Real-time username lookup for 39 mobile games and live-streaming apps. One simple GET request per game — get a clean JSON back. This page covers everything you need: authentication, the response schema, every endpoint, and copy-paste samples in cURL, JavaScript, Python, and PHP.
Introduction
The Game ID Checker API takes a player's in-game user ID and returns the username associated with that account in real time. It's the same primitive that powers thousands of top-up shops, reseller bots, and community moderation tools — exposed as a single, predictable HTTP endpoint per game.
Every endpoint shares the same response shape so you only need to write your integration once. Add a new game, swap the path, and you're done.
Quickstart
Send a GET request to the endpoint for the game you want to check. Pass your API key in the x-api-key header. Here's a one-liner that verifies a Mobile Legends ID:
curl -H "x-api-key: YOUR_API_KEY" \
https://api.neferbyte.com/game-id-checker/mobile-legends/1393323764/15748const res = await fetch(
'https://api.neferbyte.com/game-id-checker/mobile-legends/1393323764/15748',
{ headers: { 'x-api-key': process.env.NEFERBYTE_KEY } }
);
const data = await res.json();
console.log(data.data.username); // → "NeferKing"import requests, os
r = requests.get(
"https://api.neferbyte.com/game-id-checker/mobile-legends/1393323764/15748",
headers={"x-api-key": os.environ["NEFERBYTE_KEY"]},
)
print(r.json()["data"]["username"]) # → "NeferKing"<?php
$ch = curl_init("https://api.neferbyte.com/game-id-checker/mobile-legends/1393323764/15748");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["x-api-key: " . getenv("NEFERBYTE_KEY")],
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);
echo $res['data']['username']; // → "NeferKing"Authentication
Every request must include a valid API key in the x-api-key request header (lowercase or X-Api-Key — both are accepted). Keys are 32-character MD5 hashes issued when you subscribe.
GET /game-id-checker/mobile-legends/1393323764/15748 HTTP/1.1
Host: api.neferbyte.com
x-api-key: a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6Getting a key
- RapidAPI — sign up at rapidapi.com/nazi436123/api/id-game-checker. RapidAPI keys only work on the RapidAPI gateway, not on the URLs in this doc.
- Direct (Telegram) — open @idgamecheckerbot, pick a plan, and the bot will send your key. This is the key to use here.
Base URL
All Direct-API endpoints share one base URL. Append the game slug, then the player ID (and server, where the game requires one).
https://api.neferbyte.com/game-id-checker/{game}/{id}/{server?}{game}— the game slug (e.g.mobile-legends). Slugs are case-sensitive.{id}— the player's user ID, exactly as the player would type it in-game.{server}— only required for some games (e.g. Mobile Legends server, Valorant tag).
Response schema
Every successful response has the same shape, regardless of which game you queried. Just three fields inside data: game, userId, username.
Success — 200 OK
{
"success": true,
"data": {
"game": "Mobile Legends",
"userId": "1393323764",
"username": "NeferKing"
}
}Error
{
"error": true,
"msg": "Can't find a username for \"User ID: 99999\"."
}Field reference
| Field | Type | Description |
|---|---|---|
success | boolean | Present and true when the lookup succeeded. Absent on errors. |
error | boolean | Present and true on failures. Absent on success. |
msg | string | Human-readable error message. Only present on errors. |
data.game | string | The canonical display name of the game (e.g. Mobile Legends). |
data.userId | string | Echoes the ID you queried — useful for correlating in batch jobs. |
data.username | string | The in-game nickname currently associated with that ID. |
success, not just HTTP status. Some upstream providers return 200 with "error": true when the ID is invalid.Errors
Errors are flat JSON with error: true and a msg field. Common cases:
| Message | Meaning | How to fix |
|---|---|---|
Authentication is required. | The x-api-key header is missing. | Add the header. |
Enter a valid X-Api-Key. | The key is malformed or unknown. | Check for typos. Keys are 32-char MD5. |
Sorry, you don't have an active subscription. | Plan expired or never activated. | Renew on RapidAPI or via Telegram. |
Sorry, you don't have an active subscription for this endpoint. | The endpoint requires an add-on (e.g. BGMI). | Contact @NeferByte. |
You have reached your daily limit today. | Daily quota for your plan is exhausted. | Wait until quota reset or upgrade plan. |
The ID field is required. | You didn't pass an ID. | Append the ID to the path. |
The ID field must contain only numbers. | Most games take numeric IDs. | Strip non-digits before sending. |
The Tag field must contain valid tags. | Supercell games expect a tag like #GR0JGQ0P. | Prefix with #, alphanumerics only. |
Can't find a username for "User ID: …". | The ID doesn't exist or the upstream is rate-limiting. | Validate the ID; retry once after 2–3s. |
Under maintenance. | The endpoint is temporarily disabled. | Check the bot for status updates. |
Rate limits
Each plan has a fixed daily request budget. The counter resets at 00:00 UTC. When you hit the cap you'll get the You have reached your daily limit today. error. Plan tiers and exact quotas are listed inside @idgamecheckerbot under /plans, or on the RapidAPI listing.
There is no per-second rate limit beyond the global anti-abuse layer — but treat each lookup as if it costs upstream bandwidth (it does). Cache results in your own database when possible.
Testing your key
The fastest way to confirm your key works: query Mobile Legends with a known-good ID. If you get a username back, you're set.
curl -H "x-api-key: $YOUR_KEY" \
https://api.neferbyte.com/game-id-checker/mobile-legends/1393323764/15748Endpoints
39 endpoints live, all sharing the same response shape. Browse below or jump straight to a game — every path is GET /game-id-checker/{slug}/.... To verify which endpoints are up right now, peek at the live status page.
Games
Live & social
Mobile Legends
Free Fire
Free Fire (Indonesia & SEA region). For the global Garena route, use ff-global.
Free Fire Global
Free Fire global (Garena) route. Returns the player's region in addition to the username.
BGMI
Battlegrounds Mobile India (BGMI). Same character UID schema as PUBG Mobile Global.
Sorry, you don't have an active subscription for this endpoint. Contact @NeferByte to enable.PUBG Mobile Global
PUBG Mobile Global player lookup. Response includes a is_ban flag.
PUBG Mobile Lite
PUBG Mobile Lite character lookup.
Call of Duty Mobile
Call of Duty: Mobile player lookup.
Valorant
Riot ID lookup. Pass the name and the tag (the part after #) as separate path segments.
Honor of Kings
Honor of Kings (王者荣耀) player lookup. Response includes is_ban.
Arena of Valor
Arena of Valor (AoV) player lookup.
Blood Strike
Blood Strike player lookup.
Arena Breakout
Arena Breakout (Tencent shooter) player lookup.
Pokemon Unite
Pokémon Unite trainer lookup.
Genshin Impact
Genshin Impact UID lookup. Response includes the resolved server (asia / eu / na / cn).
MU Devils Awaken
MU: Devils Awaken character lookup.
MU Origin 3
MU Origin 3 character lookup.
Dragon Raja
Dragon Raja character lookup.
LifeAfter
LifeAfter survivor lookup.
OPM: The Strongest
One Punch Man: The Strongest hero lookup.
Metal Slug
Metal Slug: Awakening character lookup.
Revelation
Revelation: Infinite Journey character lookup.
NIKKE: Goddess of Victory
Goddess of Victory: NIKKE commander lookup.
Eggy Party
Eggy Party (NetEase) avatar lookup.
Tom & Jerry: Chase
Tom and Jerry: Chase player lookup.
Whiteout Survival
Whiteout Survival chief lookup.
Ace Racer
Ace Racer (NetEase) racer lookup.
Speed Drifters
Garena Speed Drifters racer lookup.
Magic Chess: Go Go
Magic Chess: Go Go (Moonton autobattler) player lookup.
Delta Force Mobile
Delta Force Mobile (Tencent global) operator lookup.
Delta Force Mobile (Garena)
Delta Force Mobile via the Garena publishing region.
Teen Patti Gold
Teen Patti Gold player lookup.
Jawaker
Jawaker card games player lookup.
Bigo Live
Bigo Live broadcaster lookup.
Poppo Live
Poppo Live host lookup.
Tumile
Tumile video-chat user lookup.
LivU
LivU video chat user lookup.
Higgs Domino
Higgs Domino Island player lookup.
MixU
MixU social user lookup.
Hiya
Hiya social user lookup.
Changelog
- 2026-05-11 — Documentation re-synced with the live Direct API: 39 active endpoints (32 games + 7 live/social). Stale slugs corrected (
CoD-mobile→cod-mobile,pubg-lite→pubgm-lite,free-fire-global→ff-global); deprecated games (Point Blank, Royal Dream, Mico Live, Nimo TV, Likee, 4Fun, and other chat apps that are no longer routed) removed; BGMI, PUBG Mobile Global, Honor of Kings, Genshin Impact, Blood Strike, Arena Breakout, MU titles, Dragon Raja, LifeAfter, NIKKE, Eggy Party, Whiteout Survival, Ace Racer, Speed Drifters, MCGG, DFM, and Bigo Live added. - 2025-05-06 — Earlier rewrite to the current Direct API surface (unified
error/status/msg/dataschema). - 2025-04-29 —
game-id-checkerrewrite layer added; all endpoints now path-based instead of?game=query. - Earlier — Legacy schema (
error/status/msg/data{id,avatar,username}) deprecated. The current schema has noavatarfield.
Support
Stuck on something, found a bug, or want a new game added? Reach out:
- Telegram: @NeferByte
- Bot: @idgamecheckerbot
- Email: [email protected]