---
title: "Create a game from a FEN-style setup string, as returned by play_export_fen. Pass the same variant the position was exported from."
method: POST
path: "/api/tools/play_load_fen"
---

# Create a game from a FEN-style setup string, as returned by play_export_fen. Pass the same variant the position was exported from.

`POST /api/tools/play_load_fen`

## Request

- Base URL: `https://tools.moddable.games`
- URL: `https://tools.moddable.games/api/tools/play_load_fen`
- Auth: none declared

## Request body

- object
  - `family` string, required: Game family (chess, draughts, go, reversi, shogi, xiangqi, mancala, morris, hex, landlords-game, backgammon, standard-52, bavarian-32, flower-48, double-six-dominoes, mahjong, standard-dice, agon, asalto, chaupar, dou-shou-qi, fanorona, halma, nyout, pachisi, royal-ur, senet, stern-halma, surakarta, tafl)
  - `fen` string, required: Position string in FEN-style notation for the family
  - `variant` string: Optional variant slug (default: the family's default game)

## Response `200`

Tool result

---

[API](https://skmtc.dev/moddable/apis/moddable-games-tools.md) · [All operations](https://skmtc.dev/moddable/apis/moddable-games-tools/llms.txt) · [OpenAPI document](https://skmtc.dev/moddable/apis/moddable-games-tools/revisions/637a0b62cb9a?raw)
