API-Integration

vatcheck.tax bietet eine leistungsstarke REST-API, die B2B-Plattformen ermöglicht, UK- und europäische USt-IdNrn. direkt in ihren Checkout- oder Rechnungsstellungsabläufen automatisch zu verifizieren.

Endpunkt: Mehrere USt-IdNrn. verifizieren

Anfrage-Header

• Authorization: Bearer YOUR_API_KEY
• Content-Type: application/json

Anfragekörper (JSON)

Übermitteln Sie ein Array von bis zu 100 USt-Strings. Das API-Gateway nutzt Smart Routing, um automatisch zu bestimmen, ob HMRC oder VIES-Datenbanken abgefragt werden sollen.

{
  "vatNumbers": [
    "GB123456789",
    "DE987654321"
  ]
}

Beispielantwort

Die API gibt ein konsolidiertes Array von Ergebnisobjekten zurück. Beachten Sie das Flag reverseChargeEligible, das Ihre Steuerregeln für den EU/UK-grenzüberschreitenden Handel automatisieren hilft.

{
  "results": [
    {
      "vatNumber": "GB123456789",
      "countryCode": "GB",
      "valid": true,
      "businessName": "UK Example Limited",
      "address": "123 London St, UK",
      "timestamp": "2026-04-01T10:00:00.000Z",
      "routing": "HMRC API",
      "reverseChargeEligible": true
    },
    {
      "vatNumber": "DE987654321",
      "countryCode": "DE",
      "valid": true,
      "businessName": "DE Enterprise GmbH",
      "timestamp": "2026-04-01T10:00:00.500Z",
      "routing": "European Commission VIES API",
      "reverseChargeEligible": true
    }
  ]
}

Ratenbegrenzung & Fehler

Standard-SaaS-Pläne sind auf 100 Anfragen pro Minute beschränkt. Bei Überschreitung wird ein HTTP 429 Too Many Requests-Fehler zurückgegeben. Wenn eine vorgelagerte Regierungsregistrierung offline ist, kann der Endpunkt HTTP 503 Service Unavailable zurückgeben.