Game List Query

Query the list of active games authorized for the current Agent.

API Information

Property	Value
Path	POST /papi/v1/game/list
Authentication	Agent Token (Bearer)
Content-Type	application/x-www-form-urlencoded

Request Headers

Header	Value	Required
Authorization	Bearer {agent_token}	✅ Yes

Request Parameters

Parameter	Type	Required	Description
provider	string	No	Game provider code (e.g., GSC, SA, WM)
game_type	string	No	Game type (e.g., SLOT, LIVE, LOTTERY, POKER), equivalent to category
category	string	No	Game category, takes priority over game_type
currency	string	No	Settlement currency code, returns games supporting this currency (use all for no filter)
page	int	No	Page number, default 1
pageSize	int	No	Page size, default 10, maximum 100

Request Example

curl -X POST https://api.example.com/papi/v1/game/list \
  -H "Authorization: Bearer {agent_token}" \
  -d "provider=GSC&game_type=SLOT&page=1&pageSize=20"

Response Fields

Data Fields

Field	Type	Description
list	array	List of game objects
total	int	Total count
page	int	Current page
pageSize	int	Page size

list[Item] Fields

Field	Type	Description
id	string	Game GUID
name	string	Game name
code	string	Game code
category_code	string	Game category code (corresponds to game_type in DB)
game_type	string	Game category code (same as category_code)
currency	string	Settlement currency code
provider	string	Game provider code
brand	string	Game brand
image	string	Game image URL
is_maintenance	boolean	Whether the game is in maintenance

Successful Response

{
  "status": true,
  "code": 0,
  "data": {
    "list": [
      {
        "id": "210889a00fc2472992eb040d10d4527f",
        "name": "10 Sparkling Crown",
        "code": "526",
        "category_code": "SLOT",
        "game_type": "SLOT",
        "currency": "IDR",
        "provider": "GSC",
        "brand": "JA",
        "image": "https://images.gscplusmd.com/statics/staging/publics/images/games/1/1091/SLOT/526.png",
        "is_maintenance": false
      }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 20
  },
  "msg": "获取成功"
}

Error Response

{
  "status": false,
  "code": 7,
  "data": {},
  "msg": "operator_code mismatch"
}