{"openapi":"3.0.3","info":{"title":"Game ID Checker","version":"0.4.1","description":"Look up game accounts and nicknames through one API. Use GET /games?enabled=true for current availability. Disabled games return 503; provider failures are never classified as invalid accounts."},"servers":[{"url":"https://gameidchecker.com/api/v1","description":"Canonical API origin. Marketplace consumers use the RapidAPI gateway."}],"security":[{"RapidAPIKey":[],"RapidAPIHost":[]},{"DirectBearer":[]}],"paths":{"/games":{"get":{"operationId":"listGames","summary":"List game IDs, names and required fields","responses":{"200":{"description":"Supported games with only their unique IDs, names and required request fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GameList"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"parameters":[{"name":"enabled","in":"query","required":false,"description":"Filter by configured enabled status. Omit to list all supported games.","schema":{"type":"boolean"}}]}},"/check":{"post":{"operationId":"checkPlayer","summary":"Check a player ID and retrieve the nickname","requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Game_mlbb_Input"},{"$ref":"#/components/schemas/Game_pubgm_Input"},{"$ref":"#/components/schemas/Game_freefire_Input"},{"$ref":"#/components/schemas/Game_freefire-max_Input"},{"$ref":"#/components/schemas/Game_mcgg_Input"},{"$ref":"#/components/schemas/Game_hok_Input"},{"$ref":"#/components/schemas/Game_aov_Input"},{"$ref":"#/components/schemas/Game_codm_Input"},{"$ref":"#/components/schemas/Game_fc-mobile_Input"},{"$ref":"#/components/schemas/Game_wild-rift_Input"}]},"examples":{"mlbb":{"summary":"Illustrative ID","value":{"game":"mlbb","player_id":"123456789","zone_id":"1234"}},"pubgm":{"summary":"Illustrative ID","value":{"game":"pubgm","player_id":"5123456789"}},"freefire":{"summary":"Illustrative ID","value":{"game":"freefire","player_id":"123456789"}},"freefire-max":{"summary":"Illustrative ID","value":{"game":"freefire-max","player_id":"123456789"}},"mcgg":{"summary":"Illustrative ID","value":{"game":"mcgg","player_id":"123456789","zone_id":"1234"}},"hok":{"summary":"Illustrative ID","value":{"game":"hok","player_id":"123456789"}},"aov":{"summary":"Illustrative ID","value":{"game":"aov","player_id":"123456789"}},"codm":{"summary":"Illustrative ID","value":{"game":"codm","player_id":"12345678901234567890"}},"fc-mobile":{"summary":"Illustrative ID","value":{"game":"fc-mobile","player_id":"1234567890123456789012345"}},"wild-rift":{"summary":"Illustrative ID — integration currently unavailable","value":{"game":"wild-rift","player_id":"ExamplePlayer#1234"}}}}}},"responses":{"200":{"description":"Lookup completed; inspect data.valid. data.region_code is a provider-reported uppercase country code, or null when unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckResult"},"examples":{"mlbbWithRegion":{"summary":"Illustrative MLBB account with region","value":{"success":true,"data":{"game":"mlbb","player_id":"123456789","zone_id":"1234","valid":true,"nickname":"Example Player","region_code":"MM"},"checked_at":"2026-11-09T00:00:00.000Z","request_id":"00000000-0000-4000-8000-000000000000"}},"pubgmWithoutRegion":{"summary":"Illustrative account without region data","value":{"success":true,"data":{"game":"pubgm","player_id":"5123456789","valid":true,"nickname":"Example Player","region_code":null},"checked_at":"2026-11-09T00:00:00.000Z","request_id":"00000000-0000-4000-8000-000000000000"}},"invalidAccount":{"summary":"Confirmed invalid account","value":{"success":true,"data":{"game":"mlbb","player_id":"1","zone_id":"1","valid":false,"nickname":null,"region_code":null},"checked_at":"2026-11-09T00:00:00.000Z","request_id":"00000000-0000-4000-8000-000000000000"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"},"504":{"$ref":"#/components/responses/Error"}}}}},"components":{"securitySchemes":{"RapidAPIKey":{"type":"apiKey","in":"header","name":"X-RapidAPI-Key","description":"Consumer's RapidAPI application key. Validated by RapidAPI."},"RapidAPIHost":{"type":"apiKey","in":"header","name":"X-RapidAPI-Host","description":"Assigned RapidAPI listing hostname."},"DirectBearer":{"type":"http","scheme":"bearer","description":"Owner-only DIRECT_API_KEY for requests outside RapidAPI."}},"schemas":{"Error":{"type":"object","required":["success","error","request_id"],"properties":{"success":{"type":"boolean","enum":[false]},"request_id":{"type":"string","format":"uuid"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"CheckData":{"type":"object","required":["game","player_id","valid","nickname","region_code"],"properties":{"game":{"type":"string","enum":["mlbb","pubgm","freefire","freefire-max","mcgg","hok","aov","codm","fc-mobile","wild-rift"]},"player_id":{"type":"string","minLength":1,"maxLength":65},"zone_id":{"type":"string","pattern":"^[1-9][0-9]{0,15}$"},"valid":{"type":"boolean"},"nickname":{"type":"string","nullable":true},"region_code":{"type":"string","nullable":true,"pattern":"^[A-Z]{2}$","minLength":2,"maxLength":2,"description":"Uppercase two-letter account country code reported by the provider (for example MM). Null when unavailable or the account is invalid. Not inferred from zone_id or request location; availability varies by game and account.","example":"MM"}}},"CheckResult":{"type":"object","required":["success","data","checked_at","request_id"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"$ref":"#/components/schemas/CheckData"},"checked_at":{"type":"string","format":"date-time"},"request_id":{"type":"string","format":"uuid"}}},"Game":{"type":"object","additionalProperties":false,"required":["id","name","required_fields"],"properties":{"id":{"type":"string","enum":["mlbb","pubgm","freefire","freefire-max","mcgg","hok","aov","codm","fc-mobile","wild-rift"]},"name":{"type":"string"},"required_fields":{"type":"array","items":{"type":"string","enum":["game","player_id","zone_id"]}}}},"GameList":{"type":"object","required":["success","data","request_id"],"properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"array","items":{"$ref":"#/components/schemas/Game"}},"request_id":{"type":"string","format":"uuid"}}},"Game_mlbb_Input":{"type":"object","additionalProperties":false,"required":["game","player_id","zone_id"],"properties":{"game":{"type":"string","enum":["mlbb"]},"player_id":{"type":"string","minLength":1,"maxLength":32,"pattern":"^[1-9][0-9]*$","description":"Player ID"},"zone_id":{"type":"string","pattern":"^[1-9][0-9]{0,15}$"}}},"Game_pubgm_Input":{"type":"object","additionalProperties":false,"required":["game","player_id"],"properties":{"game":{"type":"string","enum":["pubgm"]},"player_id":{"type":"string","minLength":1,"maxLength":32,"pattern":"^[1-9][0-9]*$","description":"Player ID"}}},"Game_freefire_Input":{"type":"object","additionalProperties":false,"required":["game","player_id"],"properties":{"game":{"type":"string","enum":["freefire"]},"player_id":{"type":"string","minLength":1,"maxLength":32,"pattern":"^[1-9][0-9]*$","description":"Player ID"}}},"Game_freefire-max_Input":{"type":"object","additionalProperties":false,"required":["game","player_id"],"properties":{"game":{"type":"string","enum":["freefire-max"]},"player_id":{"type":"string","minLength":1,"maxLength":32,"pattern":"^[1-9][0-9]*$","description":"Player ID"}}},"Game_mcgg_Input":{"type":"object","additionalProperties":false,"required":["game","player_id","zone_id"],"properties":{"game":{"type":"string","enum":["mcgg"]},"player_id":{"type":"string","minLength":1,"maxLength":32,"pattern":"^[1-9][0-9]*$","description":"Player ID"},"zone_id":{"type":"string","pattern":"^[1-9][0-9]{0,15}$"}}},"Game_hok_Input":{"type":"object","additionalProperties":false,"required":["game","player_id"],"properties":{"game":{"type":"string","enum":["hok"]},"player_id":{"type":"string","minLength":1,"maxLength":32,"pattern":"^[1-9][0-9]*$","description":"Player ID"}}},"Game_aov_Input":{"type":"object","additionalProperties":false,"required":["game","player_id"],"properties":{"game":{"type":"string","enum":["aov"]},"player_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$","description":"Player ID"}}},"Game_codm_Input":{"type":"object","additionalProperties":false,"required":["game","player_id"],"properties":{"game":{"type":"string","enum":["codm"]},"player_id":{"type":"string","minLength":1,"maxLength":50,"pattern":"^[A-Za-z0-9_-]+$","description":"OpenID"}}},"Game_fc-mobile_Input":{"type":"object","additionalProperties":false,"required":["game","player_id"],"properties":{"game":{"type":"string","enum":["fc-mobile"]},"player_id":{"type":"string","minLength":1,"maxLength":25,"pattern":"^[1-9][0-9]*$","description":"Player ID"}}},"Game_wild-rift_Input":{"type":"object","additionalProperties":false,"required":["game","player_id"],"properties":{"game":{"type":"string","enum":["wild-rift"]},"player_id":{"type":"string","minLength":1,"maxLength":65,"pattern":"^[^#\\u0000-\\u001f\\u007f]+#[^#\\s\\u0000-\\u001f\\u007f]+$","description":"Riot ID"}}}},"responses":{"Error":{"description":"Request, configuration or provider error. RapidAPI can independently reject requests before they reach the Worker.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer"},"description":"Retry delay in seconds, when present."}}}}}}