Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vatly.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
not_found

HTTP Status: 404 Not Found

​
Example response

{
  "error": {
    "code": "not_found",
    "message": "No VAT rates found for country code: XX",
    "docs_url": "https://docs.vatly.dev/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 code: 
    curl -H "Authorization: Bearer vtly_live_your_api_key" \
  "https://api.vatly.dev/v1/rates/NL"
  2. List all supported countries to find the right code: 
    curl -H "Authorization: Bearer vtly_live_your_api_key" \
  "https://api.vatly.dev/v1/rates"
  3. Note: Greece uses EL (not GR), following the EU VIES convention

​
Catching this error with the SDKs

import Vatly, { VatlyError } from '@vatly/node';

const vatly = new Vatly('vtly_live_your_api_key');
const { data, error } = await vatly.vat.validate({ vatNumber: '...' });

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