Overview

The Puzzle API generates complete Anagrama puzzles — everything you need to build a word puzzle game: the target word, scrambled letters, a letter pool with decoy letters, pre-computed hints, all valid alternate anagram answers, and definitions.

Authentication required. All Puzzle API endpoints require an API key. Pass it as Authorization: Bearer ak_your_key. Get an API key

What's in a puzzle

Target word — the answer the player needs to find

Scrambled letters — the target word's letters shuffled for display

Letter pool — target letters plus decoy letters, shuffled together as a letter bank

Hints — pre-computed reveal order so hints can be given one letter at a time

Alternate answers — other valid anagrams of the same letters (e.g. “panel” and “penal” for “plane”)

Definitions — for the target word and all alternates

Difficulty Levels

Difficulty	Word Length	Extra Letters	Description
`easy`	4–5 letters	0–1	Small pool, fewer decoys
`medium`	5–6 letters	1–2	Moderate pool
`hard`	6–7 letters	3–4	Large pool, more decoys

Building a game

Generate a puzzle via GET /api/v1/puzzles/generate
Display the letter pool — show pool as the letter bank players pick from
Validate guesses with GET /api/v1/words/validate
Give Wordle-style feedback — compare guess to target for positional marks (correct / present / absent)
Use hints from the hints array to reveal letters one at a time
Check for win — player wins when their guess matches target or any word in alts

Generate Puzzle

GET /api/v1/puzzles/generate

Generate a complete Anagrama puzzle with target word, letter pool, hints, and alternate answers.

Was this page helpful?