EU VAT & EORI Validation API Documentation

1. Quick VAT Validate — GET /validate

Instantly check if a VAT number is valid without creating an audit. Powered by VIESAC multi-source intelligence combining VIES, supported national registries, VIESAC SmartRouter™, VIESAC SmartCache™, and VIESAC AI Engine.

For quick lookups only — no audit record is stored. For a full, legally reliable verification with a timestamped certificate, use POST /audits.

curl -X GET "https://viesac.eu/api/v1/validate?vat=DE123456789" \
  -H "Authorization: Bearer YOUR_API_KEY"

$url = 'https://viesac.eu/api/v1/validate?' . http_build_query(['vat' => 'DE123456789']);
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $apiKey],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

// $data['status'] → 'valid' / 'invalid'

import requests

response = requests.get(
    "https://viesac.eu/api/v1/validate",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"vat": "DE123456789"},
)
data = response.json()

# data["status"] → "valid" / "invalid"

const res = await fetch(
  `https://viesac.eu/api/v1/validate?${new URLSearchParams({ vat: 'DE123456789' })}`,
  { headers: { Authorization: `Bearer ${apiKey}` } }
);
const data = await res.json();

// data.status → "valid" / "invalid"

Response (200) — VAT is valid:

{
  "vat": "DE123456789",
  "country_code": "DE",
  "vat_number": "123456789",
  "status": "valid",
  "checked_at": "2026-03-16T12:00:00+00:00"
}

Response (200) — VAT is not valid:

{
  "vat": "DE000000000",
  "country_code": "DE",
  "vat_number": "000000000",
  "status": "invalid",
  "checked_at": "2026-03-16T12:00:00+00:00"
}

Response (200) — Audit required (VIES unavailable and no fallback result):

{
  "vat": "DE123456789",
  "country_code": "DE",
  "vat_number": "123456789",
  "status": "audit_required",
  "checked_at": "2026-03-16T12:00:00+00:00",
  "code": "audit_required",
  "next_step": "create_audit",
  "create_audit_url": "https://viesac.eu/app/vat-validation",
  "docs_url": "https://viesac.eu/api-docs"
}

Rate limit response (429):

{
  "error": "VAT validation limit exceeded. Your current plan allows 10 live VAT validations per hour.",
  "code": "rate_limit_exceeded",
  "limit": 10,
  "window": "1 hour",
  "retry_after": 1800,
  "upgrade_url": "https://viesac.eu/app/payment"
}

Monthly validation limit response (429):

{
  "error": "Monthly VAT validation limit exceeded. Your current plan allows 100 VAT validations per month.",
  "code": "monthly_validation_limit_exceeded",
  "limit": 100,
  "window": "1 month",
  "upgrade_url": "https://viesac.eu/app/payment"
}

2. Quick EORI Validate — GET /eori/validate

Instantly check if an EORI number is valid across the EU (via European Commission EOS) and UK (via HMRC) without creating an audit.

For quick lookups only — no audit record is stored. For a full, legally reliable verification with a timestamped certificate, use POST /audits with type="eori" or hybrid type="vat_eori".

curl -X GET "https://viesac.eu/api/v1/eori/validate?eori=GB123456789000" \
  -H "Authorization: Bearer YOUR_API_KEY"

$url = 'https://viesac.eu/api/v1/eori/validate?' . http_build_query(['eori' => 'GB123456789000']);
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $apiKey],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

// $data['status'] → 'valid' / 'invalid'

import requests

response = requests.get(
    "https://viesac.eu/api/v1/eori/validate",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"eori": "GB123456789000"},
)
data = response.json()

# data["status"] → "valid" / "invalid"

const res = await fetch(
  `https://viesac.eu/api/v1/eori/validate?${new URLSearchParams({ eori: 'GB123456789000' })}`,
  { headers: { Authorization: `Bearer ${apiKey}` } }
);
const data = await res.json();

// data.status → "valid" / "invalid"

Response (200) — EORI is valid:

{
  "eori": "GB123456789000",
  "country_code": "GB",
  "eori_number": "123456789000",
  "status": "valid",
  "name": "Example Logistics Ltd",
  "address": "1 Customs Way, Dover",
  "checked_at": "2026-03-16T12:00:00+00:00"
}

Response (200) — EORI is invalid:

{
  "eori": "GB000000000000",
  "country_code": "GB",
  "eori_number": "000000000000",
  "status": "invalid",
  "name": null,
  "address": null,
  "checked_at": "2026-03-16T12:00:00+00:00"
}

3. Get account — GET /account

Get plan and audit statistics.

curl -X GET "https://viesac.eu/api/v1/account" \
  -H "Authorization: Bearer YOUR_API_KEY"

$ch = curl_init('https://viesac.eu/api/v1/account');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

response = requests.get("https://viesac.eu/api/v1/account",
    headers={"Authorization": f"Bearer {api_key}"},
)
data = response.json()

const res = await fetch("https://viesac.eu/api/v1/account", {
  headers: { "Authorization": `Bearer ${apiKey}` },
});
const data = await res.json();

Response (200):

{
  "plan": "FREE",
  "plan_label": "Free",
  "audit_limit": 5,
  "audit_limit_period": "lifetime",
  "audit_requests_used": 1,
  "audit_requests_remaining": 4,
  "monthly_limit": 5,
  "requests_total": 4,
  "requests_this_month": 1,
  "requests_remaining": 4,
  "validation_monthly_limit": 100,
  "validation_requests_this_month": 24,
  "validation_remaining_this_month": 76,
  "validation_rate_limit": 10,
  "validation_rate_window": "hour",
  "validation_requests_this_window": 4,
  "validation_remaining_this_window": 6,
  "validation_hourly_limit": 10,
  "validation_requests_this_hour": 4,
  "validation_remaining_this_hour": 6,
  "upgrade_url": "https://viesac.eu/app/payment"
}

5. List audits — GET /audits

List audits with filters. Query params: type (vat default, eori, vat_eori, all), vat_number, eori_number, country_code, date_from, date_to, limit.

curl -X GET "https://viesac.eu/api/v1/audits?limit=50&country_code=DE&date_from=2026-02-01" \
  -H "Authorization: Bearer YOUR_API_KEY"

$url = 'https://viesac.eu/api/v1/audits?'.http_build_query(['limit'=>50,'country_code'=>'DE']);
$ch = curl_init($url);
curl_setopt_array($ch, [CURLOPT_HTTPHEADER=>['Authorization: Bearer '.$apiKey], CURLOPT_RETURNTRANSFER=>true]);
$data = json_decode(curl_exec($ch), true);

response = requests.get("https://viesac.eu/api/v1/audits",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"limit":50,"country_code":"DE"},
)
data = response.json()

const res = await fetch(`https://viesac.eu/api/v1/audits?${new URLSearchParams({limit:50,country_code:'DE'})}`,
  { headers: { "Authorization": `Bearer ${apiKey}` } }
);
const data = await res.json();

Response (200):

{
  "data": [
    {
      "reference_number": "VAC-20260216-ABC123",
      "country_code": "DE",
      "vat_number": "123456789",
      "status": "valid",
      "company_name": "Example GmbH",
      "requested_at": "2026-02-13T12:00:00.000000Z",
      ...
    }
  ],
  "count": 1
}

6. Get audit — GET /audits/{reference_number}

Get full details of a single audit by its reference number.

curl -X GET "https://viesac.eu/api/v1/audits/VAC-20260216-ABC123" \
  -H "Authorization: Bearer YOUR_API_KEY"

$ref = 'VAC-20260216-ABC123';
$ch = curl_init('https://viesac.eu/api/v1/audits/'.$ref);
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

ref = "VAC-20260216-ABC123"
response = requests.get(f"https://viesac.eu/api/v1/audits/{ref}",
    headers={"Authorization": f"Bearer {api_key}"},
)
data = response.json()

const ref = 'VAC-20260216-ABC123';
const res = await fetch(`https://viesac.eu/api/v1/audits/${ref}`, {
  headers: { "Authorization": `Bearer ${apiKey}` },
});
const data = await res.json();

Response (200):

{
  "reference_number": "VAC-20260216-ABC123",
  "type": "vat",
  "country_code": "DE",
  "vat_number": "123456789",
  "status": "valid",
  "vies": 1,
  "company_name": "Example GmbH",
  "company_address": "Example Str. 1\n10115 Berlin",
  "consultation_number": "12345678901234",
  "certificate_url": "https://viesac.eu/cert/...?locale=en",
  "certificate_xml_url": "https://viesac.eu/cert/.../xml",
  "certificate_urls": {"pdf_en":"...","pdf_locale":"...","xml":"..."},
  "requested_at": "2026-02-13T12:00:00.000000Z"
}

404 if reference not found: {"error":"No audit found for this reference number."}

8. Check partner — GET /partners/check?q=

Search by VAT (e.g. DE123456789) or company name. Returns full list per company with last status, last check date, and monitoring info if set.

curl -X GET "https://viesac.eu/api/v1/partners/check?q=DE123456789" \
  -H "Authorization: Bearer YOUR_API_KEY"

$q = urlencode('DE123456789');
$ch = curl_init('https://viesac.eu/api/v1/partners/check?q='.$q);
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

response = requests.get("https://viesac.eu/api/v1/partners/check",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"q": "DE123456789"},
)
data = response.json()

const res = await fetch(`https://viesac.eu/api/v1/partners/check?${new URLSearchParams({q: 'DE123456789'})}`, {
  headers: { "Authorization": `Bearer ${apiKey}` },
});
const data = await res.json();

Response (200):

{
  "data": [
    {
      "company_name": "Example GmbH",
      "vat": "DE123456789",
      "country_code": "DE",
      "vat_number": "123456789",
      "address": "Example Str. 1\n10115 Berlin",
      "last_status": "valid",
      "last_check_date": "2026-02-13T12:00:00.000000Z",
      "monitoring": { "frequency": "month", "next_check_at": "2026-03-13T12:00:00.000000Z" }
    }
  ],
  "count": 1
}

If no partners match: data is [], count is 0, and message is included.

Query official VAT rates for all supported countries or a single country. Free and unlimited across all plans, requiring a free API key (0 quota deduction). Supports filtering by ?country=DE,FR or ?eu_only=true, as well as conditional HTTP caching (ETag / 304 Not Modified).

# 1. Fetch all rates
curl -X GET "https://viesac.eu/api/v1/rates" \
  -H "Authorization: Bearer YOUR_API_KEY"

# 2. Query a specific country (e.g. Germany)
curl -X GET "https://viesac.eu/api/v1/rates/DE" \
  -H "Authorization: Bearer YOUR_API_KEY"

# 3. Filter specific countries with EU-only flag
curl -X GET "https://viesac.eu/api/v1/rates?country=DE,FR,ES&eu_only=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

// Single country rate lookup
$country = 'DE';
$url = 'https://viesac.eu/api/v1/rates/' . $country;

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer ' . $apiKey,
    ],
]);
$response = json_decode(curl_exec($ch), true);

$standardRate = $response['data']['standard_rate']; // 19.0
$reducedRate = $response['data']['reduced_rate'];   // 7.0
$currency = $response['data']['currency'];          // 'EUR'

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}

# Fetch rates for all EU countries
response = requests.get(
    "https://viesac.eu/api/v1/rates",
    headers=headers,
    params={"eu_only": "true"}
)
rates_catalog = response.json()["data"]

# Example: Get Spain's super-reduced rate and Canary Islands info
es = rates_catalog.get("ES", {})
print(f"Standard: {es['standard_rate']}%, Super-reduced: {es['super_reduced_rate']}%")
for territory in es.get("special_territories", []):
    print(f"Territory: {territory['region']} -> {territory['tax_name']}")

// Fetch rates for Germany or France
const res = await fetch("https://viesac.eu/api/v1/rates/DE", {
    headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const { data } = await res.json();

console.log(`${data.country_name} (${data.tax_abbr}): Standard rate ${data.standard_rate}%, Reduced ${data.reduced_rate}%`);
// Output: Germany (MwSt): Standard rate 19%, Reduced 7%

Response (200 OK):

{
  "status": "success",
  "count": 30,
  "verified_at": "2026-09-16",
  "data": {
    "DE": {
      "country_code": "DE",
      "country_name": "Germany",
      "tax_name": "Mehrwertsteuer / Umsatzsteuer",
      "tax_abbr": "MwSt",
      "is_eu_member": true,
      "currency": "EUR",
      "standard_rate": 19.0,
      "reduced_rate": 7.0,
      "reduced_rates": [7.0],
      "super_reduced_rate": null,
      "parking_rate": null,
      "rates": [
        {
          "rate": 19.0,
          "type": "standard",
          "category": null,
          "description": "Standard VAT rate applicable to most taxable goods and services"
        },
        {
          "rate": 7.0,
          "type": "reduced",
          "category": null,
          "description": "Reduced VAT rate applicable to qualifying supplies"
        }
      ],
      "special_territories": [
        {
          "region": "Heligoland and Büsingen",
          "tax_name": "Exempt",
          "standard_rate": 0.0,
          "is_eu_vat_territory": false,
          "note": "Excluded from EU VAT territory under Article 6 of Directive 2006/112/EC."
        }
      ],
      "valid_from": null,
      "verified_at": "2026-09-16",
      "source_url": "https://europa.eu/youreurope/business/finance-and-tax/vat/vat-rules-rates/index_en.htm"
    },
    "ES": {
      "country_code": "ES",
      "country_name": "Spain",
      "tax_name": "Impuesto sobre el Valor Añadido",
      "tax_abbr": "IVA",
      "is_eu_member": true,
      "currency": "EUR",
      "standard_rate": 21.0,
      "reduced_rate": 10.0,
      "reduced_rates": [10.0],
      "super_reduced_rate": 4.0,
      "parking_rate": null,
      "special_territories": [
        {
          "region": "Canary Islands (Islas Canarias)",
          "tax_name": "IGIC (Impuesto General Indirecto Canario)",
          "standard_rate": 7.0,
          "reduced_rates": [0.0, 3.0],
          "increased_rates": [9.5, 15.0],
          "is_eu_vat_territory": false,
          "note": "Excluded from EU VAT territory under Article 6 of Directive 2006/112/EC. Local IGIC applies."
        }
      ],
      "valid_from": null,
      "verified_at": "2026-09-16",
      "source_url": "https://europa.eu/youreurope/business/finance-and-tax/vat/vat-rules-rates/index_en.htm"
    }
  }
}