Integrazione API

vatcheck.tax fornisce un'API REST ad alte prestazioni progettata per aiutare le piattaforme B2B a verificare automaticamente i numeri IVA del Regno Unito ed europei direttamente nei loro flussi di checkout o fatturazione.

Endpoint: Verifica multipli numeri IVA

Header della richiesta

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

Corpo della richiesta (JSON)

Invia un array di fino a 100 stringhe IVA. Il gateway API utilizza lo Smart Routing per determinare automaticamente se interrogare i database HMRC o VIES.

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

Risposta di esempio

L'API restituisce un array consolidato di oggetti risultato. Nota la presenza del flag reverseChargeEligible, che aiuta ad automatizzare le tue regole fiscali per il commercio transfrontaliero 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
    }
  ]
}

Limitazione della velocità ed errori

I piani SaaS standard sono limitati a 100 richieste al minuto. Il superamento di questo limite restituirà un errore HTTP 429 Too Many Requests. Se un registro governativo a monte è offline, l'endpoint può restituire HTTP 503 Service Unavailable.