Integración API

vatcheck.tax proporciona una API REST de alto rendimiento diseñada para ayudar a las plataformas B2B a verificar automáticamente los números de IVA del Reino Unido y europeos directamente en sus flujos de pago o facturación.

Endpoint: Verificar múltiples números de IVA

Cabeceras de solicitud

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

Cuerpo de la solicitud (JSON)

Envíe un array de hasta 100 cadenas de IVA. La pasarela API utiliza Smart Routing para determinar automáticamente si consultar las bases de datos de HMRC o VIES.

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

Ejemplo de respuesta

La API devuelve un array consolidado de objetos de resultado. Tenga en cuenta la presencia del flag reverseChargeEligible, que ayuda a automatizar sus reglas fiscales para el comercio transfronterizo 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
    }
  ]
}

Limitación de velocidad y errores

Los planes SaaS estándar están limitados a 100 solicitudes por minuto. Superar este límite devolverá un error HTTP 429 Too Many Requests. Si un registro gubernamental ascendente está fuera de línea, el endpoint puede devolver HTTP 503 Service Unavailable.