Is this the official EU check?

Yes. The request goes to VIES, the European Commission's VAT Information Exchange System, which queries the member state's own tax database in real time. There is no intermediate database, so an answer here matches what you would get from the Commission's own web form.

Why is the trader name empty for German numbers?

Germany and Spain do not disclose trader name and address through VIES as a matter of policy. The number is still confirmed as registered or not — only the identity fields are withheld. The response sets name_disclosed: false so you can distinguish policy redaction from a genuinely empty field.

What happens when a member state's system is down?

VIES routes to each member state's own database, and those go offline for maintenance. When that happens you get HTTP 503 with a clear message, and no credits are charged. Retry after a few minutes — the outage is on the tax authority's side, not ours.

Which country codes are supported?

All 27 member states plus XI for Northern Ireland under the Windsor Framework. Note that Greece files VAT as EL, not its ISO code GR. Great Britain (GB) left VIES after Brexit and is not covered.

Can I get a consultation number for my audit trail?

The consultation_number field carries VIES's request identifier when one is issued. That identifier is what a tax authority accepts as proof that you verified a counterparty's VAT status on a given date, which matters for reverse-charge invoicing.

[ doğrulama · vergi ]● 3 kredi · dakikada 20 istek

AB KDV numarası doğrulama API

Herhangi bir Avrupa KDV numarasını, Avrupa Komisyonu'nun resmî kaydı VIES üzerinden doğrulayın. Gerçek zamanlı teyit ve üye devletin açıkladığı durumlarda kayıtlı unvan ile adres.

Resmî VIES kaynağı27 devlet + XIGerçek zamanlı denetim

auth · x-api-key

API Key

API key'iniz yok mu?

API key'lerinizi oluşturmak ve yönetmek için hesabınızda oturum açın.

Oturum Aç API Key'leri Yönet

[ 02 · integrate ]

Entegrasyon rehberi

Bir snippet kopyalayın, API anahtarınızı yerleştirin, çalıştırın. Herhangi bir HTTP istemcisinde çalışır — aşağıdaki örnekler cURL, JavaScript ve Python içindir.

spec

GET/api/validate-vat

base

https://www.apipick.com

Validate an EU VAT number against the official VIES registry

parametreler

vat_numberstringzorunlu

Full VAT number with its two-letter member-state prefix. Spaces, dots, and hyphens are stripped. IE6388047V

countrystringisteğe bağlı

Member-state code, if the number is supplied without its prefix. Greece is EL, not GR. IE

curl -X GET "https://www.apipick.com/api/validate-vat" \
  -H "x-api-key: YOUR_API_KEY"

● 200 · yanıt

{
  "vat_number": "IE6388047V",
  "country_code": "IE",
  "number": "6388047V",
  "valid": true,
  "name": "GOOGLE IRELAND LIMITED",
  "address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
  "name_disclosed": true,
  "request_date": "2026-09-01T11:52:22.440Z",
  "consultation_number": null,
  "source": "European Commission VIES",
  "credits_used": 3,
  "remaining_credits": 97
}

Gerçek Dünya Kullanım Senaryoları İçin Tasarlandı

🧾

Tersine yükümlülükle faturalama

Sınır ötesi bir B2B faturasına sıfır oran uygulamadan önce alıcının KDV kaydını teyit edin ve bu denetimi kayıt altına alın.

🚪

B2B müşteri kabulü

Kayıt sırasında doğrulayın ve müşteriden yazmasını istemek yerine ticari unvan ile adresi doğrudan sicilden doldurun.

🛡️

Dolandırıcılık önleme

Uydurma veya süresi dolmuş KDV numaralarını, faturalama sisteminize ya da bir vergi beyanına ulaşmadan önce yakalayın.

🤖

Ajan iş akışları

Bir finans ajanına, fatura işlerken çağırabileceği tek parametreli bir araç verin ve kesin bir doğru/yanlış yanıtı alın.

Yanıt alanları

Alan	Tür	Açıklama
valid	boolean	Numaranın hâlihazırda sınır ötesi ticaret için kayıtlı olup olmadığı
country_code	string	Beyan edildiği biçimiyle üye devlet kodu (Yunanistan için EL, Kuzey İrlanda için XI)
number	string	Ülke ön eki olmadan KDV numarası
name	string \| null	Üye devletin açıkladığı durumlarda kayıtlı mükellef unvanı
address	string \| null	Üye devletin açıkladığı durumlarda kayıtlı adres
name_disclosed	boolean	Üye devlet kimlik alanlarını ilke gereği paylaşmadığında false (Almanya, İspanya)
request_date	string \| null	VIES'in bu denetim için kaydettiği zaman damgası
consultation_number	string \| null	VIES sorgu tanımlayıcısı; doğrulamanın kanıtı olarak kullanılabilir
credits_used	integer	Bu istek için düşülen kredi
remaining_credits	integer	Hesabınızda kalan kredi

[ 03 · limits ]

Rate limit'ler

Sınırlama, API anahtarı başına ve 60 saniyelik kayan pencere ile uygulanır. Sınıra ulaştığınızda Retry-After başlığıyla birlikte temiz bir 429 alırsınız.

istek hızı

20req/min

API anahtarı başına, endpoint başına. 60 saniyelik kayan pencere.

eşzamanlılık

3concurrent

API anahtarı başına maksimum eşzamanlı işlemdeki istek sayısı.

yanıt başlıkları

X-RateLimit-LimitDakika başına izin verilen maksimum istek sayısı

X-RateLimit-RemainingMevcut penceredeki kalan istek sayısı

X-RateLimit-ResetMevcut pencere sıfırlanana kadarki saniye

Retry-AfterYeniden denemeden önce beklenecek saniye (yalnızca 429'da)

● 429 · çok fazla istek

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 20
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 20 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}

Veri kaynağı ve lisans

Denetimler, Avrupa Komisyonu'nun KDV Bilgi Değişim Sistemi VIES üzerinden yürür; VIES her sorguyu gerçek zamanlı olarak ilgili üye devletin kendi vergi veritabanına iletir. Sicilin hiçbir kopyasını tutmuyoruz — yanıt vergi idaresine aittir; biz yalnızca kesinti ve paylaşmama durumlarını açıkça belirterek temiz bir JSON hâlinde sunuyoruz.

Sıkça Sorulan Sorular

S: Bu, AB'nin resmî denetimi mi?

C: Evet. İstek, Avrupa Komisyonu'nun KDV Bilgi Değişim Sistemi VIES'e gider ve VIES ilgili üye devletin kendi vergi veritabanını gerçek zamanlı sorgular. Arada bir veritabanı bulunmadığından buradaki yanıt, Komisyon'un kendi web formundan alacağınızla aynıdır.

S: Alman numaralarında mükellef unvanı neden boş geliyor?

C: Almanya ve İspanya, ilke gereği mükellef unvanını ve adresini VIES üzerinden paylaşmıyor. Numaranın kayıtlı olup olmadığı yine net biçimde teyit edilir; yalnızca kimlik alanları paylaşılmaz. Yanıt name_disclosed: false değerini ayarlar; böylece ilke gereği paylaşılmamayı gerçekten boş bir alandan ayırt edebilirsiniz.

S: Bir üye devletin sistemi çöktüğünde ne olur?

C: VIES istekleri her üye devletin kendi veritabanına yönlendirir ve bunlar bakım için çevrimdışı olabilir. Böyle bir durumda açık bir mesajla HTTP 503 alırsınız ve hiç kredi düşülmez. Birkaç dakika sonra yeniden deneyin — kesinti vergi idaresi tarafındadır, bizde değil.

S: Hangi ülke kodları destekleniyor?

C: 27 üye devletin tamamı ile Windsor Çerçevesi kapsamında Kuzey İrlanda için XI. Yunanistan'ın KDV'yi ISO kodu GR ile değil EL koduyla beyan ettiğini unutmayın. Büyük Britanya (GB) Brexit sonrası VIES'ten ayrıldı ve kapsam dışıdır.

S: Denetim izim için bir sorgu numarası alabilir miyim?

C: Verildiği durumlarda consultation_number alanı VIES sorgu tanımlayıcısını taşır. Bir vergi idaresinin, muhatabın KDV durumunu belirli bir tarihte doğruladığınıza dair kanıt olarak kabul ettiği şey tam da bu tanımlayıcıdır; tersine yükümlülükte bu önemlidir.