Featured providers

Live

GET/api/v1/games/providers/featured

The curated featured-provider row for your site, sorted by position. If you have not curated your own list, the platform's global picks are returned.

Only providers actually offered on your site are returned — a pinned provider that is disabled or not held drops out of the list automatically.

Headers

Field	Type	Required	Description
Authorization	string	—	Not used — this endpoint is public; no member token required
X-Api-Key	string	Yes	Agent API key (ak_…) from the bo screen
X-Timestamp	string	Yes	Signing time in unix milliseconds (±300s skew allowed)
X-Nonce	string	Yes	Unique per-request value (UUIDv4) for replay protection
X-Signature	string	Yes	hex(HMAC-SHA256(secret, canonical)) — see the Authentication page
X-Player-IP	string	—	The player's real IP (IPv4/IPv6) — recommended (used in login history)
X-Player-UA	string	—	The player's User-Agent (optional — recorded in login history)
X-Request-Id	string	—	Your correlation id — echoed back as request_uuid (recommended)
x-lang	string	—	th (default) or en — the language of message

Response

Fields in data

Field	Type	Required	Description
data[]	array<object>	—	Featured providers, sorted by position
└ position	number	—	Slot position (starts at 1)
└ provider	object	—	Provider object (same shape as the provider list)
└ id	string (uuid)	—	Provider id — use as ?provider_id= on the game list
└ code	string	—	Provider code, e.g. PGSOFT
└ name	string	—	Display name
└ logo_url	string \| null	—	Provider logo URL
└ categories	string[]	—	Game categories this provider carriesSLOT \| ARCADE \| LIVE_CASINO \| TABLE \| FISHING \| SPORT \| LOTTERY \| ESPORT \| KENO \| COCKFIGHT
└ game_count	number	—	Number of games
└ launch_game_id	string \| null	—	Single-game providers (game_count = 1, e.g. sportsbook / live casino) → the one game's id so you can launch straight from the provider card without a game list. null = the provider has a game list.
└ maintenance_until	string \| null	—	Under maintenance until this time (if null = operating normally)
└ sort_order	number	—	Recommended display order

Response example

{
  "success": true,
  "code": 0,
  "message": "สำเร็จ",
  "data": [
    {
      "position": 1,
      "provider": {
        "id": "b7a3e6c2-1f4d-4e8a-9c5b-2d7f8a1e3b6c",
        "code": "PGSOFT",
        "name": "PG Soft",
        "logo_url": "https://cdn.example.com/providers/pgsoft.png",
        "categories": ["SLOT"],
        "game_count": 138,
        "launch_game_id": null,
        "maintenance_until": null,
        "sort_order": 1
      }
    },
    {
      "position": 2,
      "provider": {
        "id": "2c8e4a6b-9d1f-4b3a-a5c7-e0f2d4b6a8c1",
        "code": "SAGAME",
        "name": "SA Gaming",
        "logo_url": "https://cdn.example.com/providers/sagame.png",
        "categories": ["LIVE_CASINO"],
        "game_count": 1,
        "launch_game_id": "6e1d3b5f-7a9c-4e2b-8d0f-1a3c5e7b9d2f",
        "maintenance_until": null,
        "sort_order": 4
      }
    }
  ],
  "request_uuid": "9f2b7d1e-4a83-4c1f-b2ce-6d5a0e8f3c21"
}

Possible error codes

code	Name	HTTP	Message
4002	BAD_REQUEST	400	Bad requestThe request's agent could not be resolved (unknown domain/credential)