TaxVett Python SDK

Python client for the TaxVett API — validates VAT/tax registration numbers across EU, UK, Australia, Norway, and Singapore.

Install

pip install taxvett

Quick start

Sync

from taxvett import TaxVett

client = TaxVett(api_key="tv_...")

result = client.validate("SE556677881301")
print(result["valid"])        # True
print(result["company_name"]) # "Acme AB"

Async

import asyncio
from taxvett import AsyncTaxVett

async def main():
    client = AsyncTaxVett(api_key="tv_...")
    result = await client.validate("SE556677881301")
    print(result["valid"])

asyncio.run(main())

Methods

validate(number, country=None)

Validate a single tax number. country is optional — the API will auto-detect it.

result = client.validate("GB123456789", country="GB")
# result: ValidateResponse

validate_batch(numbers)

Validate multiple numbers in one request.

from taxvett import BatchItem

numbers: list[BatchItem] = [
    {"number": "SE556677881301"},
    {"number": "GB123456789", "country": "GB"},
]
response = client.validate_batch(numbers)
print(response["count"])    # 2
print(response["results"])  # list[ValidateResponse]

get_stats()

Retrieve usage statistics for your API key.

stats = client.get_stats()
print(stats["total_requests"])
print(stats["requests_by_country"])
print(stats["requests_per_day"])

Error handling

from taxvett import TaxVett, TaxVettError

client = TaxVett(api_key="tv_...")

try:
    result = client.validate("INVALID")
except TaxVettError as e:
    print(e.status)  # e.g. 401, 400, 500
    print(e.body)    # raw response body as dict

Custom base URL

client = TaxVett(api_key="tv_...", base_url="https://staging.taxvett.com")