List live games (public)

GET

/games

const url = 'https://play-api.jc.id.lv/games';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://play-api.jc.id.lv/games

Every live game on the node, with both seats’ public faces. Sorted by version desc, capped at 50.

Responses

200

Live games with a total count.

application/json

object

games

required

Array<object>

object

gameId

required

string

players

object

white

required

A participant’s public, spectator-safe face — never a raw id.

object

kind

required

string

Allowed values: Bot Human

name

Team-qualified bot name

string | null

black

required

A participant’s public, spectator-safe face — never a raw id.

object

kind

required

string

Allowed values: Bot Human

name

Team-qualified bot name

string | null

timeControl

required

One of:

A single-key time-control wrapper.

object

Unlimited

required

object

activeSeat

required

string

Allowed values: White Black

dicePending

required

boolean

clocks

Remaining milliseconds per side as of the carrying event; null on Unlimited games.

object

white

integer

black

integer

version

required

integer

dfen

required

string

total

required

integer

Example

{
  "games": [
    {
      "players": {
        "white": {
          "kind": "Bot"
        },
        "black": {
          "kind": "Bot"
        }
      },
      "activeSeat": "White"
    }
  ]
}