> ## Documentation Index
> Fetch the complete documentation index at: https://docs.avatcado.com/llms.txt
> Use this file to discover all available pages before exploring further.

# not_found

> Error: requested resource was not found

# not\_found

<Info>HTTP Status: **404 Not Found**</Info>

## Example response

```json theme={null}
{
  "error": {
    "code": "not_found",
    "message": "No VAT rates found for country code: XX",
    "docs_url": "https://docs.avatcado.com/errors/not_found"
  },
  "meta": {
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}
```

## What happened?

The requested resource does not exist. Common cases:

* **VAT Rates**: The country code you provided doesn't match any country in our database
* The resource was removed or never existed

## How to fix

1. **Check the country code**. Use a valid [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code:
   ```bash theme={null}
   curl -H "Authorization: Bearer avat_live_your_api_key" \
     "https://api.avatcado.com/v1/rates/NL"
   ```
2. **List all supported countries** to find the right code:
   ```bash theme={null}
   curl -H "Authorization: Bearer avat_live_your_api_key" \
     "https://api.avatcado.com/v1/rates"
   ```
3. **Note**: Greece uses `EL` (not `GR`), following the EU VIES convention

## Catching this error with the SDKs

<CodeGroup>
  ```typescript @avatcado/node theme={null}
  import Avatcado, { AvatcadoError } from '@avatcado/node';

  const avatcado = new Avatcado('avat_live_your_api_key');
  const { data, error } = await avatcado.vat.validate({ vatNumber: '...' });

  if (error instanceof AvatcadoError) {
    console.log(`${error.code}: ${error.message}`);
    console.log(error.docsUrl);
  }
  ```

  ```python Python theme={null}
  from avatcado import Avatcado, AvatcadoError

  avatcado = Avatcado("avat_live_your_api_key")

  try:
      result = avatcado.vat.validate("...")
  except AvatcadoError as e:
      print(f"{e.code}: {e.message}")
      print(e.docs_url)
  ```
</CodeGroup>

## Related errors

* [`unauthorized`](/errors/unauthorized): API key is missing or invalid
* [`validation_error`](/errors/validation_error): Request input failed validation