{
"request_id": "a4cb6aeb4c9c5f97",
"iban": {
"input": "DE89370400440532013000",
"valid": true,
"iban": "DE89370400440532013000",
"iban_formatted": "DE89 3704 0044 0532 0130 00",
"country_code": "DE",
"check_digits": "89",
"bban": "370400440532013000",
"bank_code": "37040044",
"branch_code": null,
"account_number": "0532013000",
"sepa": true,
"bank": {
"bic": "COBADEFFXXX",
"name": "Commerzbank Köln"
},
"source": "offline",
"error": null,
"cached": true
},
"billable": false,
"usage": {
"plan": "zyla",
"used": 2,
"limit": null,
"remaining": null,
"reset_at": "2026-11-01T00:00:00.000Z",
"note": "Quota and billing for Zyla API Hub subscriptions are managed by Zyla API Hub, the marketplace you subscribed through."
}
}
curl --location --request POST 'https://zylalabs.com/api/14335/eu+vat+and+iban+validation+api/35930/validate+vat+and+iban' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"iban":"DE89370400440532013000"}'
{
"plan": "zyla",
"plan_name": "Zyla API Hub",
"price_usd_per_month": 0,
"monthly_quota": null,
"used": 2,
"remaining": null,
"period_start": "2026-10-01T00:00:00.000Z",
"reset_at": "2026-11-01T00:00:00.000Z",
"rate_limit_per_minute": 600,
"requests_this_month": 7,
"key_id": null,
"marketplace": "zyla",
"note": "Quota and billing for Zyla API Hub subscriptions are managed by Zyla API Hub, the marketplace you subscribed through."
}
curl --location --request GET 'https://zylalabs.com/api/14335/eu+vat+and+iban+validation+api/35931/usage+and+plan+status' --header 'Authorization: Bearer YOUR_API_KEY'
{
"ok": true,
"service": "vat-iban-api",
"time": "2026-10-18T23:45:55.174Z"
}
curl --location --request GET 'https://zylalabs.com/api/14335/eu+vat+and+iban+validation+api/35932/health+check' --header 'Authorization: Bearer YOUR_API_KEY'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Validación de IVA y IBAN de la UE API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
Valida los números de IVA de la UE a través de VIES y los IBAN con búsqueda de BIC. En caché, a prueba de fallos.
El endpoint de Validar el IVA y el IBAN devuelve resultados de validación para números de IVA de la UE e IBAN, incluidos el estado de validez, el IBAN formateado, el código de país, los detalles del banco y los mensajes de error si corresponde. El endpoint de Uso y Estado del Plan proporciona información sobre el plan actual y las métricas de uso, mientras que el endpoint de Verificación de Salud indica el estado del servicio y la versión
Los campos clave incluyen "válido" (indicando validez) "iban_formateado" (IBAN formateado) "código_pais" (país del IBAN) "banco" (contiene BIC y nombre del banco) y "error" (cualquier error de validación) El endpoint de Uso incluye "utilizado" (llamadas realizadas) y "reset_en" (próxima fecha de restablecimiento)
Los datos devueltos están estructurados en formato JSON Cada respuesta contiene objetos anidados como "iban" para detalles del IBAN y "usage" para información del plan Este formato estructurado permite un fácil análisis e integración en aplicaciones
El endpoint de Validar VAT e IBAN proporciona resultados de validación para números de VAT e IBAN, incluyendo detalles de la empresa cuando están disponibles. El endpoint de Uso ofrece información sobre el uso de la API, mientras que el endpoint de Verificación de Salud confirma la disponibilidad y el estado del servicio
Envía una solicitud POST con un cuerpo JSON que contenga "vat" (número de IVA de la UE con su prefijo de país de 2 letras, por ejemplo DE123456789; usa XI para Irlanda del Norte) y/o "iban" (por ejemplo {"iban":"DE89370400440532013000"}). Puedes pasar uno o ambos campos en una solicitud
Los datos de respuesta están organizados en objetos principales como "iban" para resultados de validación de IBAN y "uso" para métricas de uso de la API Cada objeto contiene campos relevantes lo que facilita el acceso a información específica como validez y detalles bancarios
Los datos del IVA provienen en vivo del VIES (Sistema de Intercambio de Información sobre el IVA) de la UE, cubriendo los 27 estados miembros de la UE más Irlanda del Norte; el nombre/dirección de la empresa se devuelven si el estado miembro los proporciona. Los resultados se almacenan en caché durante 24 horas y durante las interrupciones de VIES se utiliza un resultado conocido como bueno (o válido:null con una sugerencia de reintento). Los IBAN se validan fuera.
Los casos de uso típicos incluyen verificar la validez de los números de IVA para la facturación asegurar el cumplimiento de las regulaciones fiscales y validar los IBAN para transacciones financieras seguras Esto ayuda a las empresas a evitar errores en la facturación y los pagos
Valid:null significa que el servicio VIES en línea para ese estado miembro no estaba disponible y no había un resultado en caché (último conocido bueno) al que recurrir. La respuesta incluye un consejo de reintento; por favor intente de nuevo más tarde. No es una solicitud fallida y no significa que el número de IVA sea inválido
Aún no Reino Unido (GB) la validación del IVA a través de HMRC llegará pronto Los números de IVA de Irlanda del Norte (XI) ya son compatibles a través de VIES junto con los 27 estados miembros de la UE