# Vatly

> Developer-friendly VAT and GST validation API for 32 countries

## What is Vatly?
Vatly is a REST API for validating VAT and GST numbers across 32 countries. It wraps VIES (27 EU member states + Northern Ireland), HMRC (United Kingdom), the Swiss BFS UID Register (Switzerland + Liechtenstein), the Norwegian Bronnysund Register, and the Australian ABR behind a single endpoint with structured JSON responses, built-in caching, and test mode. Built for developers who need reliable VAT/GST validation in billing, checkout, or compliance flows.

## API
- Base URL: https://api.vatly.dev
- Auth: Bearer token (API key with `vtly_live_` or `vtly_test_` prefix)
- Single validation: GET /v1/validate?vat_number={vat_number}
- Batch validation: POST /v1/validate/batch (up to 50, Pro/Business only)
- VAT rates: GET /v1/rates (free, unlimited, no quota usage)
- Response envelope: { data, meta } or { error, meta }

## Pricing
- Free: EUR 0/month, 500 validations
- Pro: EUR 29/month, 10,000 validations
- Business: EUR 99/month, 50,000 validations

## Coverage
- 27 EU member states via VIES
- United Kingdom via HMRC
- Northern Ireland (XI prefix) via VIES
- Switzerland (CH) and Liechtenstein (LI) via BFS UID Register
- Norway (NO) via Bronnysund Enhetsregisteret

## Key Features
- 25-day result caching with stale fallback when upstream is down
- Test mode with magic VAT numbers (no upstream calls, no quota usage)
- Structured error responses with machine-readable codes and docs_url
- Input normalization (handles messy formatting automatically)
- Rate limit headers on every response
- Consultation numbers for audit proof (pass requester_vat_number)
- TypeScript SDK: @vatly/node (npm)

## Links
- Website: https://vatly.dev
- API Docs: https://docs.vatly.dev
- API Docs (LLM-optimized): https://docs.vatly.dev/llms.txt
- OpenAPI Spec: https://docs.vatly.dev/openapi.yaml
- Status: https://status.vatly.dev
- SDK: https://www.npmjs.com/package/@vatly/node
- GitHub: https://github.com/getvatly