Validate a VAT number format

Code snippets

curl "https://api.oanor.com/vatid-api/v1/validate" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/vatid-api/v1/validate", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/vatid-api/v1/validate");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/vatid-api/v1/validate",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "Offline format/structure validation against the country's VAT pattern. A valid format does not guarantee the number is registered — use a VIES lookup for that. Example: DE123456789, ATU12345678.",
        "valid": true,
        "inputs": {
            "vat": "DE123456789"
        },
        "country": "Germany",
        "normalized": "DE123456789",
        "country_code": "DE",
        "expected_format": "9 digits"
    },
    "meta": {
        "timestamp": "2026-06-05T19:50:13.007Z",
        "request_id": "034e9fb7-198e-4942-9d06-3f5d3fdaa361"
    },
    "status": "ok",
    "message": "Validate VAT number",
    "success": true
}