Spectator Rooms

Lists currently in-progress human-vs-human rooms — useful for building a "watch live games" surface. Bot games and non-active rooms are excluded.

GET/v1/rooms?game=checkers

Lists active spectator-eligible rooms for a game.

bash

curl "https://api.beta-gamer.com/v1/rooms?game=checkers" \
  -H "Authorization: Bearer bg_live_xxxx"

Response

json

{
  "rooms": [
    {
      "roomId": "r_88f2",
      "game": "checkers",
      "players": [
        { "id": "user_1", "username": "Alex" },
        { "id": "user_2", "username": "Jordan" }
      ],
      "moveCount": 14
    }
  ]
}

This endpoint currently supports checkers only, among the games documented here. The other five aren't exposed for spectating yet.

← Previous

Webhooks

Error Codes