> This page is for Documentation, version Integration guides (default).
> For other versions, use one of these documentation indexes:
> - Integration guides (default): https://avalara.ferndocs.com/docs/integration-guides/llms.txt
> - Refactor guides: https://avalara.ferndocs.com/docs/refactor-guides/llms.txt
> - Get certified: https://avalara.ferndocs.com/docs/get-certified/llms.txt
> - Agent to Agent (A2A): https://avalara.ferndocs.com/docs/agent-to-agent-a2a/llms.txt
> - AI use cases: https://avalara.ferndocs.com/docs/ai-use-cases/llms.txt
> - API versioning: https://avalara.ferndocs.com/docs/api-versioning/llms.txt

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

# Errors

Guide: Brazil Returns (Tax compliance) - English

When a TaxCompliance API call produces an error, it responds using the standard [HTTP error response codes](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes "https://en.wikipedia.org/wiki/List_of_HTTP_status_codes"). Response codes between 400 and 499 are called **Client Errors**, and indicate a mistake in an API call. Response codes between 500 and 599 refer to internal errors within TaxCompliance itself.

Code

Description

400

Bad Request - refer to internal errors within TaxCompliance

401

Authentication credentials were missing or incorrect.

403

The request is denied because you do not have permission to make this alteration.

404

The URL requested is invalid or the resource requested does not exist.

429

The user has sent too many requests in a given amount of time ("rate limiting").

500

The server has encountered a situation it doesn't know how to handle

503

The server is not ready to handle the request.

[Previous](https://developer.avalara.com/extractor-en/authentication/certification_requirements)

[Next](https://developer.avalara.com/extractor-en/errors/taxcompliance_error_handling)

> **Note**
>
> Part of the **Extractor guide (English)** integration guide. [Open the full "Errors" milestone on Avalara](https://developer.avalara.com/products/tax-compliance/integration-guides/extractor-en/errors/) to see every page in this section.