> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ntropy.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ntropy.com/_mcp/server.

# Errors

The Ntropy API uses predictable HTTP status codes to signal success or failure of API requests. In the case of an
error, the API also returns a JSON body that provides further information about the error.

<Aside>

| HTTP Code     | SDK Error                | Cause                                                                            |
|---------------|--------------------------|----------------------------------------------------------------------------------|
| 400           | NtropyValueError         | One or more of the provided values is not valid for the request                  |
| 401           | NtropyNotAuthorizedError | Invalid API key provided.                                                        |
| 403           | NtropyNotSupportedError  | Operation inactive for the user. Contact us to add this feature to your key.     |
| 404           | NtropyNotFoundError      | Resource not found.                                                              |
| 422           | NtropyValidationError    | The request body does not match the expected input fields or data types.         |
| 423           | NtropyQuotaExceededError | Not enough credits to perform this operation. Please top up your account.        |
| 429           | NtropyRateLimitError     | Too many requests. See [rate limits](./rate-limits).                             |
| 502, 503, 504 | NtropyConnectionError    | Network errors on Ntropy's side. These will be automatically retried by the SDK, |
| 500           | NtropyRuntimeError       | Logical server errors on Ntropy's side.                                          |

</Aside>