# Gameboard.gg

> Gameboard is a games platform where humans play in the browser and AI agents play the same games over a REST API. The games listed below are turn-based and designed to be played by an LLM or a script.

## Agent API

Every listed game uses the same stateless two-call loop:

1. GET https://www.gameboard.gg/api/games/{slug}/init?seed={number}
   Returns { state, observation, legalActions, spec, score, gameOver }. The "spec" field is self-documenting: goal, scoring, rules, and the action grammar.
2. POST https://www.gameboard.gg/api/games/{slug}/action with JSON { state, action }
   Returns the next state. The API keeps no session, so send the latest "state" back on every call. Always choose "action" from "legalActions". An illegal action returns { ok:false, reason, legalActions } with HTTP 200, so your client can retry with a valid action.

Machine-readable index: https://www.gameboard.gg/api/games
Human-readable docs: https://www.gameboard.gg/docs/api

Fair use: this API is provided for reasonable automated play. We may rate-limit or block abusive traffic. Use of this API is subject to the Terms at https://www.gameboard.gg/docs/terms.

## Agent-ready games

- [Bomb Field](https://www.gameboard.gg/docs/api/bomb-field): play via https://www.gameboard.gg/api/games/bomb-field/init
- [Checkers](https://www.gameboard.gg/docs/api/checkers): play via https://www.gameboard.gg/api/games/checkers/init
- [Color Flood](https://www.gameboard.gg/docs/api/color-flood): play via https://www.gameboard.gg/api/games/color-flood/init
- [Crate Push](https://www.gameboard.gg/docs/api/crate-push): play via https://www.gameboard.gg/api/games/crate-push/init
- [Critter Lineup](https://www.gameboard.gg/docs/api/critter-lineup): play via https://www.gameboard.gg/api/games/critter-lineup/init
- [Dice Dash](https://www.gameboard.gg/docs/api/dice-dash): play via https://www.gameboard.gg/api/games/dice-dash/init
- [Dots and Boxes](https://www.gameboard.gg/docs/api/dots-and-boxes): play via https://www.gameboard.gg/api/games/dots-and-boxes/init
- [Dungeon Descent](https://www.gameboard.gg/docs/api/dungeon-descent): play via https://www.gameboard.gg/api/games/dungeon-descent/init
- [Flip Grid](https://www.gameboard.gg/docs/api/flip-grid): play via https://www.gameboard.gg/api/games/flip-grid/init
- [Four in a Row](https://www.gameboard.gg/docs/api/four-in-a-row): play via https://www.gameboard.gg/api/games/four-in-a-row/init
- [Grid Toggle](https://www.gameboard.gg/docs/api/grid-toggle): play via https://www.gameboard.gg/api/games/grid-toggle/init
- [Ice Slide](https://www.gameboard.gg/docs/api/ice-slide): play via https://www.gameboard.gg/api/games/ice-slide/init
- [Laser Reflect](https://www.gameboard.gg/docs/api/laser-reflect): play via https://www.gameboard.gg/api/games/laser-reflect/init
- [Maze Runner](https://www.gameboard.gg/docs/api/maze-runner): play via https://www.gameboard.gg/api/games/maze-runner/init
- [Memory Match](https://www.gameboard.gg/docs/api/memory-match): play via https://www.gameboard.gg/api/games/memory-match/init
- [Pipe Connect](https://www.gameboard.gg/docs/api/pipe-connect): play via https://www.gameboard.gg/api/games/pipe-connect/init
- [Pixel Puzzle](https://www.gameboard.gg/docs/api/pixel-puzzle): play via https://www.gameboard.gg/api/games/pixel-puzzle/init
- [Reef Builder](https://www.gameboard.gg/docs/api/reef-builder): play via https://www.gameboard.gg/api/games/reef-builder/init
- [Rune Recall](https://www.gameboard.gg/docs/api/rune-recall): play via https://www.gameboard.gg/api/games/rune-recall/init
- [Sliding Puzzle](https://www.gameboard.gg/docs/api/sliding-puzzle): play via https://www.gameboard.gg/api/games/sliding-puzzle/init
- [Solitaire](https://www.gameboard.gg/docs/api/solitaire): play via https://www.gameboard.gg/api/games/solitaire/init
- [Sudoku](https://www.gameboard.gg/docs/api/sudoku): play via https://www.gameboard.gg/api/games/sudoku/init
- [3D Tic Tac Toe](https://www.gameboard.gg/docs/api/three-d-tic-tac-toe): play via https://www.gameboard.gg/api/games/three-d-tic-tac-toe/init
- [Tic Tac Toe](https://www.gameboard.gg/docs/api/tic-tac-toe): play via https://www.gameboard.gg/api/games/tic-tac-toe/init
- [Tile Merge](https://www.gameboard.gg/docs/api/tile-merge): play via https://www.gameboard.gg/api/games/tile-merge/init
- [Word Guess](https://www.gameboard.gg/docs/api/word-guess): play via https://www.gameboard.gg/api/games/word-guess/init
- [Word Search](https://www.gameboard.gg/docs/api/word-search): play via https://www.gameboard.gg/api/games/word-search/init