VATcomply

VATcomply is a free API service providing:

• VAT number validation - Validate European VAT numbers using the official VIES database
• Foreign exchange rates - Daily rates from the European Central Bank with historical data
• Visitor IP geolocation - Automatic country detection from visitor's IP address
• IBAN validation - International Bank Account Number validation
• Country & currency data - Comprehensive country and currency information

Documentation | Interactive API Docs

Quick Start

Base URL: https://api.vatcomply.com

# Validate a VAT number
curl "https://api.vatcomply.com/vat?vat_number=BE0123456789"

# Get latest exchange rates
curl "https://api.vatcomply.com/rates"

# Get exchange rates with a specific base currency
curl "https://api.vatcomply.com/rates?base=USD&symbols=GBP,JPY"

# Validate an IBAN
curl "https://api.vatcomply.com/iban?iban=GB82WEST12345698765432"

# Geolocate visitor IP
curl "https://api.vatcomply.com/geolocate"

Development

Setup

# Install dependencies
make pip      # or: uv sync

Database Setup

# Run migrations
make migrate  # or: uv run python manage.py migrate

# Load initial data
uv run python manage.py load_countries
uv run python manage.py load_rates --last-90-days

Running the Server

make run      # or: DEBUG=True uv run python manage.py runbolt --dev

Testing

# Run all tests
make test     # or: uv run pytest

# Run specific tests
uv run pytest vatcomply/tests/test_rates.py

# Test with coverage
make coverage # or: uv run coverage run -m pytest && uv run coverage report -m

Contributing

Thanks for your interest in the project! All pull requests are welcome from developers of all skill levels. To get started, simply fork the master branch on GitHub to your personal account and then clone the fork into your development environment.

Madis Väin (madisvain on Github) is the original creator of the VATcomply API.

License

MIT