Word API
Validate Word
Check if a word exists in the dictionary. Works across all 870+ supported languages. Useful for validating player guesses in word games before scoring, or confirming a word exists before looking up its full dictionary entry.
GET/api/v1/words/validate
Requires API key
Returns whether the given word exists in the dictionary for the specified language. If valid, also returns the first part of speech found.
Query Parameters
| Name | Description |
|---|---|
wordreq | stringThe word to validate (1–100 characters). |
lang | stringISO 639 language code (e.g. en, es, ja). Use Languages to list available languages. Defaults to en. |
Request
bash
curl "https://api.playanagrama.com/api/v1/words/validate?word=bonnet" \
-H "Authorization: Bearer ak_your_key_here"Response Fields
| Name | Description |
|---|---|
word | stringThe word that was checked. |
lang | stringThe language that was checked. |
valid | booleantrue if the word exists in the dictionary for the given language. |
pos | string?Part of speech (e.g. noun, verb, adj). Only present when valid is true. |
Response 200 — Valid word
JSON
{
"word": "bonnet",
"lang": "en",
"valid": true,
"pos": "noun"
}Response 200 — Invalid word
JSON
{
"word": "zzzzz",
"lang": "en",
"valid": false
}Response 400 — Missing word
JSON
{
"error": {
"code": "INVALID_PARAMS",
"message": "word parameter is required and must be 1-100 characters."
}
}Response 404 — Language not found
JSON
{
"error": {
"code": "LANGUAGE_NOT_FOUND",
"message": "No dictionary available for language 'zz'.",
"available": "Use GET /v1/dictionary/languages for supported languages."
}
}This endpoint always returns
200 for both valid and invalid words — check the valid field in the response. A 404 only occurs when the language itself is not available. The check is case-insensitive: querying “House” matches “house”.Was this page helpful?