API v1 · Stable

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.

Two distribution channels. Subscribe via RapidAPI or directly on @idgamecheckerbot. RapidAPI keys only work on RapidAPI URLs; Direct keys only work on the URLs documented here.

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:

bash
curl -H "x-api-key: YOUR_API_KEY" \
     https://api.neferbyte.com/game-id-checker/mobile-legends/1393323764/15748
javascript
const 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"
python
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
<?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.

http
GET /game-id-checker/mobile-legends/1393323764/15748 HTTP/1.1
Host: api.neferbyte.com
x-api-key: a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

Getting a key

Keep your key server-side. Anyone with the key can drain your daily quota. Don't ship it in mobile apps or front-end JavaScript — proxy the request through your own backend.

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).

base url
https://api.neferbyte.com/game-id-checker/{game}/{id}/{server?}

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

json
{
    "success": true,
    "data": {
        "game": "Mobile Legends",
        "userId": "1393323764",
        "username": "NeferKing"
    }
}

Error

json
{
    "error": true,
    "msg": "Can't find a username for \"User ID: 99999\"."
}

Field reference

FieldTypeDescription
successbooleanPresent and true when the lookup succeeded. Absent on errors.
errorbooleanPresent and true on failures. Absent on success.
msgstringHuman-readable error message. Only present on errors.
data.gamestringThe canonical display name of the game (e.g. Mobile Legends).
data.userIdstringEchoes the ID you queried — useful for correlating in batch jobs.
data.usernamestringThe in-game nickname currently associated with that ID.
Tip: Always branch on 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:

MessageMeaningHow 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.

bash
curl -H "x-api-key: $YOUR_KEY" \
     https://api.neferbyte.com/game-id-checker/mobile-legends/1393323764/15748

Endpoints

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

GET/game-id-checker/mobile-legends/{id}/{server}

Look up a Mobile Legends: Bang Bang account by user ID and server (zone).

id
numeric, required
server
numeric, required
example
1393323764 / 15748

Free Fire

GET/game-id-checker/free-fire/{id}

Free Fire (Indonesia & SEA region). For the global Garena route, use ff-global.

id
numeric, required
example
1958604115

Free Fire Global

GET/game-id-checker/ff-global/{id}

Free Fire global (Garena) route. Returns the player's region in addition to the username.

id
numeric, required
example
12341234

BGMI

GET/game-id-checker/bgmi/{id}

Battlegrounds Mobile India (BGMI). Same character UID schema as PUBG Mobile Global.

id
numeric, required
example
5211580693
Add-on required. BGMI is gated behind a separate subscription. Without it you'll see Sorry, you don't have an active subscription for this endpoint. Contact @NeferByte to enable.

PUBG Mobile Global

GET/game-id-checker/pubgm-global/{id}

PUBG Mobile Global player lookup. Response includes a is_ban flag.

id
numeric, required
example
52115806933

PUBG Mobile Lite

GET/game-id-checker/pubgm-lite/{id}

PUBG Mobile Lite character lookup.

id
numeric, required
example
7228395004

Call of Duty Mobile

GET/game-id-checker/cod-mobile/{id}

Call of Duty: Mobile player lookup.

id
numeric, required
example
8370310192847

Valorant

GET/game-id-checker/valorant/{name}/{tag}

Riot ID lookup. Pass the name and the tag (the part after #) as separate path segments.

name
string, required
tag
string, required
example
ucup / 123

Honor of Kings

GET/game-id-checker/honor-of-kings/{id}

Honor of Kings (王者荣耀) player lookup. Response includes is_ban.

id
numeric, required
example
17960996468644334037

Arena of Valor

GET/game-id-checker/arena-of-valor/{id}

Arena of Valor (AoV) player lookup.

id
numeric, required
example
195293573153949

Blood Strike

GET/game-id-checker/blood-strike/{id}

Blood Strike player lookup.

id
numeric, required
example
123456789

Arena Breakout

GET/game-id-checker/arena-breakout/{id}

Arena Breakout (Tencent shooter) player lookup.

id
numeric, required
example
123456789

Pokemon Unite

GET/game-id-checker/pokemonunite/{id}

Pokémon Unite trainer lookup.

id
string, required
example
ABCDEFG

Genshin Impact

GET/game-id-checker/genshin/{id}

Genshin Impact UID lookup. Response includes the resolved server (asia / eu / na / cn).

id
numeric, required
example
844335555

MU Devils Awaken

GET/game-id-checker/mu-devils-awaken/{id}

MU: Devils Awaken character lookup.

id
numeric, required
example
123456789

MU Origin 3

GET/game-id-checker/mu-origin-3/{id}

MU Origin 3 character lookup.

id
numeric, required
example
123456789

Dragon Raja

GET/game-id-checker/dragon-raja/{id}

Dragon Raja character lookup.

id
numeric, required
example
123456789

LifeAfter

GET/game-id-checker/lifeafter/{id}

LifeAfter survivor lookup.

id
numeric, required
example
123456789

OPM: The Strongest

GET/game-id-checker/opm-the-strongest/{id}

One Punch Man: The Strongest hero lookup.

id
numeric, required
example
123456789

Metal Slug

GET/game-id-checker/metal-slug/{id}

Metal Slug: Awakening character lookup.

id
numeric, required
example
123456789

Revelation

GET/game-id-checker/revelation/{id}

Revelation: Infinite Journey character lookup.

id
numeric, required
example
123456789

NIKKE: Goddess of Victory

GET/game-id-checker/gov-nikke/{id}

Goddess of Victory: NIKKE commander lookup.

id
numeric, required
example
123456789

Eggy Party

GET/game-id-checker/eggy-party/{id}

Eggy Party (NetEase) avatar lookup.

id
numeric, required
example
123456789

Tom & Jerry: Chase

GET/game-id-checker/tom-and-jerry-chase/{id}

Tom and Jerry: Chase player lookup.

id
numeric, required
example
123456789

Whiteout Survival

GET/game-id-checker/whiteoutsurvival/{id}

Whiteout Survival chief lookup.

id
numeric, required
example
123456789

Ace Racer

GET/game-id-checker/ace-racer/{id}

Ace Racer (NetEase) racer lookup.

id
numeric, required
example
123456789

Speed Drifters

GET/game-id-checker/speed-drifters/{id}

Garena Speed Drifters racer lookup.

id
numeric, required
example
123456789

Magic Chess: Go Go

GET/game-id-checker/mcgg/{id}

Magic Chess: Go Go (Moonton autobattler) player lookup.

id
numeric, required
example
123456789

Delta Force Mobile

GET/game-id-checker/dfm/{id}

Delta Force Mobile (Tencent global) operator lookup.

id
numeric, required
example
123456789

Delta Force Mobile (Garena)

GET/game-id-checker/dfm-garena/{id}

Delta Force Mobile via the Garena publishing region.

id
numeric, required
example
123456789

Teen Patti Gold

GET/game-id-checker/teen-patti-gold/{id}

Teen Patti Gold player lookup.

id
numeric, required
example
100439992784

Jawaker

GET/game-id-checker/jawaker/{id}

Jawaker card games player lookup.

id
numeric, required
example
1473084005

Bigo Live

GET/game-id-checker/bigo-live/{id}

Bigo Live broadcaster lookup.

id
numeric, required
example
901234567

Poppo Live

GET/game-id-checker/poppo/{id}

Poppo Live host lookup.

id
numeric, required
example
2763759

Tumile

GET/game-id-checker/tumile/{id}

Tumile video-chat user lookup.

id
numeric, required
example
44577844

LivU

GET/game-id-checker/livu/{id}

LivU video chat user lookup.

id
numeric, required
example
55422155

Higgs Domino

GET/game-id-checker/higgs-domino/{id}

Higgs Domino Island player lookup.

id
numeric, required
example
55666

MixU

GET/game-id-checker/mixu/{id}

MixU social user lookup.

id
numeric, required
example
23232323

Hiya

GET/game-id-checker/hiya/{id}

Hiya social user lookup.

id
numeric, required
example
100648

Changelog

Support

Stuck on something, found a bug, or want a new game added? Reach out: