EU- USt-IdNr.-Prüfung API
Prüft jede EU-Umsatzsteuer-Identifikationsnummer gegen VIES, das offizielle Register der Europäischen Kommission. Bestätigung in Echtzeit, dazu Firmenname und Anschrift, sofern der Mitgliedstaat sie freigibt.
Noch keinen API-Key?
Melde dich an, um API-Keys zu erstellen und zu verwalten.
Integrationsleitfaden
Snippet kopieren, deinen API-Key einsetzen, ausführen. Funktioniert in jedem HTTP-Client — Beispiele unten in cURL, JavaScript und Python.
/api/validate-vathttps://www.apipick.comValidate an EU VAT number against the official VIES registry
vat_numberstringerforderlichFull VAT number with its two-letter member-state prefix. Spaces, dots, and hyphens are stripped. IE6388047V
countrystringoptionalMember-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"{
"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
}Gebaut für reale Anwendungsfälle
Reverse-Charge-Rechnungen
Bestätigen Sie die USt-Registrierung des Käufers, bevor Sie eine grenzüberschreitende B2B-Rechnung ohne Steuer ausstellen – und dokumentieren Sie die Prüfung.
B2B-Onboarding
Prüfen Sie bei der Registrierung und übernehmen Sie Firmenname und Anschrift direkt aus dem Register, statt sie den Kunden eintippen zu lassen.
Betrugsprävention
Fangen Sie erfundene oder abgelaufene USt-IdNrn. ab, bevor sie in Ihre Abrechnung oder eine Steuererklärung gelangen.
Agenten-Workflows
Geben Sie einem Finanz-Agenten ein Werkzeug mit einem einzigen Parameter, das er bei der Rechnungsverarbeitung aufrufen kann – mit einer eindeutigen Ja/Nein-Antwort.
Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
| valid | boolean | Ob die Nummer derzeit für den grenzüberschreitenden Handel registriert ist |
| country_code | string | Ländercode des Mitgliedstaats wie gemeldet (EL für Griechenland, XI für Nordirland) |
| number | string | Die USt-IdNr. ohne Länderpräfix |
| name | string | null | Eingetragener Firmenname, sofern der Mitgliedstaat ihn freigibt |
| address | string | null | Eingetragene Anschrift, sofern der Mitgliedstaat sie freigibt |
| name_disclosed | boolean | False, wenn der Mitgliedstaat Identitätsfelder grundsätzlich zurückhält (DE, ES) |
| request_date | string | null | Zeitstempel, den VIES für die Prüfung erfasst hat |
| consultation_number | string | null | VIES-Abfragekennung, verwendbar als Nachweis der Prüfung |
| credits_used | integer | Für diese Anfrage abgezogene Credits |
| remaining_credits | integer | Verbleibende Credits in deinem Account |
Rate-Limits
Die Drosselung erfolgt pro API-Key, gleitendes 60-Sekunden-Fenster. Beim Erreichen des Limits bekommst du ein sauberes 429 mit Retry-After-Header.
20req/min
Pro API-Key, pro Endpunkt. Gleitendes 60-Sekunden-Fenster.
3concurrent
Maximale gleichzeitige laufende Anfragen pro API-Key.
X-RateLimit-LimitMaximal zulässige Anfragen pro MinuteX-RateLimit-RemainingVerbleibende Anfragen im aktuellen FensterX-RateLimit-ResetSekunden bis zum Zurücksetzen des aktuellen FenstersRetry-AfterSekunden Wartezeit vor erneutem Versuch (nur bei 429)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
}Datenquelle & Lizenz
Geprüft wird gegen VIES, das Mehrwertsteuer-Informationsaustauschsystem der Europäischen Kommission, das jede Anfrage in Echtzeit an die Steuerdatenbank des jeweiligen Mitgliedstaats weiterleitet. Wir halten keine Kopie des Registers vor – die Antwort stammt von der Steuerverwaltung und wird als sauberes JSON geliefert, mit ausdrücklich gekennzeichneten Ausfall- und Auskunftsfällen.
Häufig gestellte Fragen
F: Ist das die offizielle EU-Prüfung?
A: Ja. Die Anfrage geht an VIES, das Mehrwertsteuer-Informationsaustauschsystem der Europäischen Kommission, das in Echtzeit die Steuerdatenbank des jeweiligen Mitgliedstaats abfragt. Es gibt keine zwischengeschaltete Datenbank, die Antwort entspricht also dem, was das Webformular der Kommission liefert.
F: Warum ist der Firmenname bei deutschen Nummern leer?
A: Deutschland und Spanien geben Firmenname und Anschrift über VIES grundsätzlich nicht heraus. Ob die Nummer registriert ist, wird dennoch eindeutig bestätigt – nur die Identitätsfelder bleiben zurückgehalten. Die Antwort setzt name_disclosed: false, damit Sie eine rechtlich bedingte Zurückhaltung von einem tatsächlich leeren Feld unterscheiden können.
F: Was passiert, wenn das System eines Mitgliedstaats ausfällt?
A: VIES leitet an die Datenbank des jeweiligen Mitgliedstaats weiter, und diese gehen zu Wartungszwecken offline. In diesem Fall erhalten Sie HTTP 503 mit einer klaren Meldung, und es werden keine Credits berechnet. Versuchen Sie es nach einigen Minuten erneut – die Störung liegt bei der Steuerverwaltung, nicht bei uns.
F: Welche Ländercodes werden unterstützt?
A: Alle 27 Mitgliedstaaten sowie XI für Nordirland nach dem Windsor-Rahmen. Beachten Sie, dass Griechenland die Umsatzsteuer unter EL meldet, nicht unter dem ISO-Code GR. Großbritannien (GB) hat VIES nach dem Brexit verlassen und ist nicht abgedeckt.
F: Bekomme ich eine Abfragenummer für meine Nachweisführung?
A: Das Feld consultation_number enthält die VIES-Abfragekennung, sofern eine vergeben wird. Genau diese Kennung akzeptiert eine Steuerverwaltung als Nachweis, dass Sie den USt-Status eines Geschäftspartners an einem bestimmten Tag geprüft haben – wichtig beim Reverse-Charge-Verfahren.