# GameIDChecker

> Game account ID and nickname lookup API for developers, resellers and top-up shops.

## Documentation

- [API guide](https://gameidchecker.com/docs/): Authentication, requests, responses and errors.
- [OpenAPI specification](https://gameidchecker.com/openapi.json): Machine-readable request and response schemas.
- [Plans](https://rapidapi.com/1xapi-rapid-team/api/game-id-checker-api/pricing): Monthly subscription quotas managed by RapidAPI.
- [Complete text reference](https://gameidchecker.com/llms-full.txt): Game-specific fields and examples.

## Request contract

Canonical API base: https://gameidchecker.com/api/v1

- GET /games: Each entry contains only id, name, required_fields. Use ?enabled=true for enabled games.
- POST /check: JSON object containing game, player_id and zone_id only where required. Send all IDs as strings.
- Requests through RapidAPI use the consumer's X-RapidAPI-Key and assigned X-RapidAPI-Host. Direct origin access requires a separate owner-issued Bearer key.
- Never put API keys in browser code or URLs.
- HTTP 200, success=true, data.valid=true includes data.nickname. data.region_code is always included: an uppercase two-letter provider-reported account country code (for example MM), or null when unavailable. It is not inferred from zone_id or request location. Explicitly invalid accounts return data.valid=false, nickname=null and region_code=null.
- HTTP 400: invalid input; 401: authentication; 413: body too large; 415: content type; 502: unexpected provider response; 503: disabled game/provider unavailable; 504: timeout. Provider errors do not mean an invalid player.
- Responses include request_id; completed checks also include checked_at. Respect Retry-After when present.

## Game-specific input

### Mobile Legends: Bang Bang

- game: mlbb
- Status: enabled
- player_id: Player ID, numeric, maximum 32 characters.
- zone_id: required, positive numeric string, up to 16 digits
- Example (illustrative, not a known-valid account): {"game":"mlbb","player_id":"123456789","zone_id":"1234"}
- Guide: https://gameidchecker.com/games/mobile-legends/

### PUBG Mobile

- game: pubgm
- Status: enabled
- player_id: Player ID, numeric, maximum 32 characters.
- zone_id: omit
- Example (illustrative, not a known-valid account): {"game":"pubgm","player_id":"5123456789"}
- Guide: https://gameidchecker.com/games/pubg-mobile/

### Free Fire

- game: freefire
- Status: enabled
- player_id: Player ID, numeric, maximum 32 characters.
- zone_id: omit
- Example (illustrative, not a known-valid account): {"game":"freefire","player_id":"123456789"}
- Guide: https://gameidchecker.com/games/free-fire/

### Free Fire MAX

- game: freefire-max
- Status: enabled
- player_id: Player ID, numeric, maximum 32 characters.
- zone_id: omit
- Example (illustrative, not a known-valid account): {"game":"freefire-max","player_id":"123456789"}
- Guide: https://gameidchecker.com/games/free-fire-max/

### Magic Chess: Go Go

- game: mcgg
- Status: enabled
- player_id: Player ID, numeric, maximum 32 characters.
- zone_id: required, positive numeric string, up to 16 digits
- Example (illustrative, not a known-valid account): {"game":"mcgg","player_id":"123456789","zone_id":"1234"}
- Guide: https://gameidchecker.com/games/magic-chess-go-go/

### Honor of Kings

- game: hok
- Status: enabled
- player_id: Player ID, numeric, maximum 32 characters.
- zone_id: omit
- Example (illustrative, not a known-valid account): {"game":"hok","player_id":"123456789"}
- Guide: https://gameidchecker.com/games/honor-of-kings/

### Arena of Valor

- game: aov
- Status: enabled
- player_id: Player ID, identifier, maximum 64 characters.
- zone_id: omit
- Example (illustrative, not a known-valid account): {"game":"aov","player_id":"123456789"}
- Guide: https://gameidchecker.com/games/arena-of-valor/

### Call of Duty Mobile (Indonesia)

- game: codm
- Status: enabled
- player_id: OpenID, identifier, maximum 50 characters.
- zone_id: omit
- Example (illustrative, not a known-valid account): {"game":"codm","player_id":"12345678901234567890"}
- Guide: https://gameidchecker.com/games/call-of-duty-mobile/

### EA SPORTS FC Mobile

- game: fc-mobile
- Status: enabled
- player_id: Player ID, numeric, maximum 25 characters.
- zone_id: omit
- Example (illustrative, not a known-valid account): {"game":"fc-mobile","player_id":"1234567890123456789012345"}
- Guide: https://gameidchecker.com/games/fc-mobile/

### League of Legends: Wild Rift

- game: wild-rift
- Status: disabled
- player_id: Riot ID, riot, maximum 65 characters.
- zone_id: omit
- Example (illustrative, not a known-valid account): {"game":"wild-rift","player_id":"ExamplePlayer#1234"}
- Guide: https://gameidchecker.com/games/wild-rift/

## Availability and scope

Wild Rift is registered but disabled and returns HTTP 503. GET /games?enabled=true returns enabled games; this is configuration availability, not a live provider health check. A nickname lookup does not verify account ownership. Game passwords are never required.