List Games `GET`

Return the ranked game list for a given provider. Used to render the lobby for Package S members.

Endpoint

http

GET {{ API_URL }}/seamless/games?productId=PGSOFTTHAI

Authorization

HTTP Basic Authentication. The Authorization header value is the Base64 encoding of {agent_username}:{api_key}.

http

Authorization: Basic Base64(agent_username:api_key)

Query parameters

Name	Type	Required	Description
`productId`	string	Required	Provider code from `ofb_game_provider` (e.g. `PGSOFTTHAI`). Returns `400` if omitted, `404` if the provider is unknown.

Response

On success the service returns 200 OK with a list of games ordered by rank ascending.

Field	Type	Description
`reqId`	string (uuid)	Per-request transaction id.
`code`	integer	Business status code. `0` on success.
`message`	string	Human-readable status. `"Success"` on success.
`data.games`	array of object	Ranked game list (see fields below).

Game object

Field	Type	Description
`name`	string?	Game display name. Omitted when the underlying record has no name.
`category`	string	Game category: `SLOT`, `FISHING`, `LIVECASINO`, ...
`type`	string	Same value as `category`. Kept for backwards compatibility.
`code`	string	Game code from `ofb_game` (e.g. `PGSOFTTHAI_SLOT_GemstonesGold`).
`img`	string	Default icon URL.
`rank`	integer	1-indexed position in the sorted list (lower = higher priority).
`providerCode`	string?	Provider code from `ofb_game_provider` (e.g. `PGSOFTTHAI`).
`locale`	object?	Localized display names. For `PGSOFTTHAI` only `th` is populated; for every other provider only `en` is populated.
`locale.en`	string?	English game name.
`locale.th`	string?	Thai game name.
`locale.cn`	string?	Simplified Chinese game name.

Example success response

json

{
  "reqId": "45b2813e-9d38-4334-9f50-176a70938ce2",
  "code": 0,
  "message": "Success",
  "data": {
    "games": [
      {
        "name": "เพชรทอง",
        "category": "SLOT",
        "type": "SLOT",
        "code": "PGSOFTTHAI_SLOT_GemstonesGold",
        "img": "https://cdn.example.com/game.png",
        "rank": 1,
        "providerCode": "PGSOFTTHAI",
        "locale": {
          "th": "เพชรทอง"
        }
      },
      {
        "name": "Gemstones Gold",
        "category": "SLOT",
        "type": "SLOT",
        "code": "PGSOFT2_SLOT_GemstonesGold",
        "img": "https://cdn.example.com/game.png",
        "rank": 2,
        "providerCode": "PGSOFT2",
        "locale": {
          "en": "Gemstones Gold"
        }
      }
    ]
  }
}

Errors

HTTP	Reason
`400`	Missing `productId` query parameter.
`401`	Missing/invalid `Authorization` header, unknown agent, or invalid API key.
`404`	The given `productId` is not registered in `ofb_game_provider`.