USt-IdNr-Prüfung per API

USt-IdNr prüfen per API, mit VIES und BZSt.

Validierung über eine REST-API. Jedes Prüfergebnis nennt die genutzte Quelle und ob es aus dem Cache stammt. BZSt qualifizierte Bestätigungen nach §18e UStG im Business-Plan. Kostenloser Einstieg, keine Kreditkarte.

Endpoint: /v1/validate/DE123456789
Beispielantwort
$ curl "https://api.giltiq.de/v1/validate/DE123456789"

Jetzt ausprobieren

So sieht eine Antwort der API aus: ein Beispiel, keine echte Abfrage.

{
  "valid": false,
  "vat_id": "DE123456789",
  "country_code": "DE",
  "vat_number": "123456789",
  "company_name": null,
  "company_address": null,
  "source": "vies",
  "source_timestamp": "2026-09-14T09:00:00.000Z",
  "cache": false,
  "qualified_confirmation": null,
  "request_id": "req_01JZ9X2Y3Z4A5B6C7D8E9F0G",
  "requested_at": "2026-09-14T09:00:00.000Z"
}
dns Gehostet auf Hetzner in Deutschland verified_user Prüfergebnisse mit Quellen- und Cache-Metadaten public_off Kein Cloudflare code Open-Source BZSt-Client stars Free-Plan: 100 Prüfungen/Monat

Anfrageabhängiges Routing über VIES und BZSt.

Ohne API-Schlüssel nutzen Live-Abfragen VIES. Bei authentifizierten einfachen Abfragen wählt die API für Umsatzsteuer-Identifikationsnummern mit Ländercode DE oder bei Angabe von requester_vat_id zuerst BZSt, mit VIES als Fallback. Andere authentifizierte einfache Abfragen nutzen VIES. Qualifizierte Anfragen gehen an BZSt. Soweit die Anfrage Caching erlaubt, kann ein gespeichertes Ergebnis zurückgegeben werden. Abgeschlossene Prüfergebnisse enthalten source, cache und source_timestamp. Ein einfaches oder zwischengespeichertes Ergebnis ersetzt keine qualifizierte Bestätigung. Sind die relevanten Quellen nicht verfügbar und liegt kein nutzbares gespeichertes Ergebnis vor, antwortet die API mit SOURCE_UNAVAILABLE (HTTP 503).

Qualifizierte Bestätigungen nach §18e UStG.

Für die qualifizierte Bestätigung übermittelt Ihr System Firmenname und Anschrift, und die API antwortet mit den BZSt-Abgleichsergebnissen (name_match, street_match, zip_match, city_match) plus einer receipt_id, über die Sie den Nachweis später abrufen können. Derzeit Teil des Business-Plans.

Für Agenten und Entwickler gebaut.

Strukturierte JSON-Antworten mit expliziten Feldern statt Freitext. Neben der REST-API veröffentlicht Giltiq eine agents.json, eine llms.txt und eine Agent Card, und betreibt einen MCP-Server für agentische Workflows. Ob Ihre Rechnungen als PDF, E-Rechnung nach EN 16931, XRechnung oder ZUGFeRD erzeugt werden, bleibt Ihrem System überlassen: die Validierung läuft davor.

Integration in Minuten

# Simple validation: GET /v1/validate/{vat_id} with your API key
curl "https://api.giltiq.de/v1/validate/DE123456789" \
  -H "X-API-Key: YOUR_API_KEY"
smart_toy REST_+_MCP

Eine API für Entwickler und Agenten.

Giltiq stellt agents.json, llms.txt und eine Agent Card bereit, damit Ihre KI-Workflows die API selbstständig entdecken und aufrufen können. Ein MCP-Server kapselt dieselben Prüfungen als Tools.

Quellen VIES_+_BZSt
Antwortformat JSON_+_Metadaten
MCP-Server verfügbar
/llms.txt
# Giltiq VAT Validation API
> EU VAT ID validation with source and cache metadata.
> GET /v1/validate/{vat_id} for a simple check.
> agents.json and an Agent Card describe agent access.

Protokoll-Integration

01

Ausprobieren

Rufen Sie die API ohne API-Schlüssel auf. Standardmäßig sind 10 Anfragen ohne Registrierung möglich.

02

Registrieren

Erstellen Sie ein Konto für einen API-Schlüssel mit 100 Prüfungen pro Monat. E-Mail ist optional.

03

Live gehen

Binden Sie den REST-Endpunkt direkt ein: GET /v1/validate/{vat_id} mit Ihrem X-API-Key-Header. Mehr braucht es nicht.

Einfache, transparente Preise

Kostenlos starten. Wächst mit Ihnen.

Free
Free

100 validations/mo

Starter
€29/mo

1.000 validations/mo

Business
€99/mo

5.000 validations/mo