POST/anagrama/api/guess
Requires API key
Submit a guess for today's puzzle. Requires a valid CLI bearer token. The server validates the guess against the puzzle answer and returns the result.
Request Body
| Name | Description |
|---|---|
wordreq | stringThe guessed word. Must use only letters from the puzzle’s letter pool. |
Request
bash
curl -X POST https://api.playanagrama.com/anagrama/api/guess \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"word":"coins"}'Response Fields
| Name | Description |
|---|---|
result | stringEither "correct" or "wrong". |
answer | stringThe correct answer. Only returned when the guess is correct. |
attempts | integerTotal number of guesses made so far. |
remaining | integerRemaining attempts. Only returned on wrong guesses. |
solved | booleanWhether the puzzle has been solved. |
Response 200 — Correct
JSON
{
"result": "correct",
"answer": "COINS",
"attempts": 3,
"solved": true
}Response 200 — Wrong
JSON
{
"result": "wrong",
"attempts": 3,
"remaining": 3
}Response 400 — Invalid
JSON
{
"error": "invalid_word",
"message": "Word is not in the dictionary or does not use the correct letters."
}A correct guess returns the answer and sets
solved: true. An incorrect but valid guess decrements remaining attempts. An invalid word (not in dictionary or wrong letters) returns a 400 and does not count as an attempt.Was this page helpful?