Tic-Tac-Toe Fetch

The /tic-tac-toe/fetch endpoint retrieves information about a current Tic-Tac-Toe game.

posthttps://api.moxon.dev/v3/tic-tac-toe/fetch

Parameters

usernamestringrequired
The username of the player
gamestringoptional
The game identifier to fetch
privatestringoptional
Set to true to fetch only private games

Request Example

Request

curl -X POST -d "username=User1&game=VWXYZ" "https://api.moxon.dev/v3/tic-tac-toe/fetch"

Response

{
    "game": "VWXYZ",
    "players": ["User1", "User2"],
    "board": [
        ["X", "", "O"],
        ["", "X", ""],
        ["O", "", ""]
    ],
    "current_turn": "User2",
    "status": "in_progress",
    "private": false,
    "created_at": "2025-01-21T10:30:00.000Z"
}

Response Fields

Field	Description
`game`	Game identifier
`players`	Array of player usernames
`board`	3x3 array representing the game board
`current_turn`	Username of the player whose turn it is
`status`	Game status (`waiting`, `in_progress`, `finished`)
`private`	Whether the game is private
`created_at`	Game creation timestamp

Error Handling

If parameters are missing or invalid, the API will return an error:

400Please provide a username (?username={username})The username parameter is missing

/v3/tic-tac-toe - Main game endpoint for making moves
/v3/tic-tac-toe/list - List all public games

Edit this page on GitHub Report an issue

Last updated on April 8, 2026