Intégration API

vatcheck.tax fournit une API REST haute performance conçue pour aider les plateformes B2B à vérifier automatiquement les numéros de TVA britanniques et européens directement dans leurs flux de paiement ou de facturation.

Point de terminaison : Vérifier plusieurs numéros de TVA

En-têtes de requête

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

Corps de la requête (JSON)

Soumettez un tableau de jusqu'à 100 chaînes TVA. La passerelle API utilise le Smart Routing pour déterminer automatiquement s'il faut interroger les bases de données HMRC ou VIES.

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

Exemple de réponse

L'API renvoie un tableau consolidé d'objets résultats. Notez la présence du flag reverseChargeEligible, qui aide à automatiser vos règles fiscales pour le commerce transfrontalier UE/UK.

{
  "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
    }
  ]
}

Limitation de débit & Erreurs

Les plans SaaS standard sont limités à 100 requêtes par minute. Dépasser cette limite retourne une erreur HTTP 429 Too Many Requests. Si un registre gouvernemental en amont est hors ligne, le point de terminaison peut renvoyer HTTP 503 Service Unavailable.