API Reference/

GET/anagrama/api/puzzle

Requires API key

Fetch today's puzzle. Returns the scrambled letters, pool scramble, and session metadata for the authenticated user.

Request

bash
curl https://api.playanagrama.com/anagrama/api/puzzle \
  -H "Authorization: Bearer YOUR_TOKEN"

Response Fields

NameDescription
id
stringUnique puzzle identifier.
dateKey
stringPuzzle date in YYYY-MM-DD format.
length
integerNumber of letters in the answer word.
scramble
stringScrambled letters in display order for the player.
poolScramble
stringFull letter pool for input validation. May include decoy letters not in the answer.
maxAttempts
integerMaximum allowed guesses before the puzzle is failed.
maxHints
integerMaximum hints available for this puzzle.
session
objectCurrent user's progress — includes attempts, hintsUsed, solved, and guesses array.

Response 200

JSON
{
  "id": "pzl_20250601",
  "dateKey": "2025-06-01",
  "length": 5,
  "scramble": "NOCIS",
  "poolScramble": "CINOS",
  "maxAttempts": 6,
  "maxHints": 2,
  "session": {
    "attempts": 0,
    "hintsUsed": 0,
    "solved": false
  }
}
The scramble field is the display order shown to the player. poolScramble is the sorted letter pool for validation. The session object tracks the current user's progress and resets daily.
Was this page helpful?
Anagrama API Docs | Developer Reference