Error Codes

Status Codes

Code	Name	Description	Resolution
`400`	Bad Request	The request is missing a required parameter or contains invalid values.	Check the request parameters. Ensure required fields like `q` are provided.
`401`	Unauthorized	Authentication failed. The API key is missing, malformed, or invalid.	Include a valid `Authorization: Bearer` header. Verify your key in the Console.
`403`	Forbidden	The API key is valid, but the associated account has been suspended or deleted.	Contact support to resolve account issues.
`404`	Not Found	The requested resource does not exist. This can mean the dictionary ID is wrong or the entry ID does not exist.	Verify the `source` and `id` parameters match values from a search response.
`429`	Too Many Requests	You have exceeded your monthly API request limit.	Wait until your quota resets next month, or upgrade your plan.
`500`	Internal Server Error	An unexpected error occurred on our side. These are rare and typically transient.	Retry the request after a brief delay. If the error persists, contact support.

Code

Name

Description

Resolution

400

Bad Request

The request is missing a required parameter or contains invalid values.

Check the request parameters. Ensure required fields like q are provided.

401

Unauthorized

Authentication failed. The API key is missing, malformed, or invalid.

Include a valid Authorization: Bearer header. Verify your key in the Console.

403

Forbidden

The API key is valid, but the associated account has been suspended or deleted.

Contact support to resolve account issues.

404

Not Found

The requested resource does not exist. This can mean the dictionary ID is wrong or the entry ID does not exist.

Verify the source and id parameters match values from a search response.

429

Too Many Requests

You have exceeded your monthly API request limit.

Wait until your quota resets next month, or upgrade your plan.

500

Internal Server Error

An unexpected error occurred on our side. These are rare and typically transient.

Retry the request after a brief delay. If the error persists, contact support.

Common Mistakes

Avoid these common pitfalls

Forgetting the Bearer prefix: The header must be Authorization: Bearer YOUR_KEY, not just Authorization: YOUR_KEY.
Using an entry ID from the wrong dictionary: Entry IDs are scoped to their dictionary. An ID from one dictionary will not work with a different source.
Not URL-encoding non-Latin characters: When using the word lookup endpoint with non-ASCII characters, ensure the word is properly URL-encoded.

Error Response Format