API de validación de NIF-IVA

Comprobar, y poder demostrarlo.

VerifyVAT consulta en directo en VIES los NIF-IVA de sus socios comerciales y guarda en cada comprobación el número de consulta oficial. Así podrá demostrar más adelante que comprobó, y cuándo.

Las cuentas nuevas empiezan con 1000 solicitudes al mes.

Justificante de comprobaciónEjemplo
Código de solicitud
VV-3F9A1C2E
NIF-IVA comprobado
DE123456789
Resultado
válido
Empresa (según VIES)
Muster GmbH
Solicitante
LU32633157
Marca de tiempo
2026-10-11 01:14:09

Número de consulta (VIES)

WAPIAAAAZ4Kq8vDn

Guardado en su cuenta, disponible en el historial y en CSV.

probado
27 + XI
Estados miembros de la UE e Irlanda del Norte, cubiertos a través de VIES
VV-…
Un código de solicitud único para cada comprobación
Prueba
El número de consulta oficial se guarda en cada solicitud
CSV
Historial completo exportable para contabilidad e inspecciones

01¿Por qué validar?

Un NIF-IVA válido suele decidir el tratamiento fiscal

Si vende a empresas de otros países de la UE, necesita saber con quién trata. El NIF-IVA del socio es el dato clave y su validez puede cambiar con el tiempo.

Entregas exentas

Las entregas intracomunitarias a empresas de otro Estado de la UE solo suelen estar exentas si el cliente usa un NIF-IVA válido. Si no puede acreditarlo, se expone a una regularización.

Inversión del sujeto pasivo

En muchos servicios B2B el destinatario liquida el impuesto. La comprobación demuestra que su cliente está registrado como empresario antes de facturar sin IVA.

Prueba en una inspección

La administración puede preguntar más tarde si comprobó y cuándo. Con el código de solicitud, la marca de tiempo y el número de consulta tiene una respuesta que no necesita reconstruir.

Esto no es asesoramiento fiscal. Qué justificantes necesita en su caso es algo que debe aclarar con su asesor fiscal.

02Simple o cualificada

La diferencia entre «válido» y «probado»

VIES conoce dos tipos de consulta. Para la documentación cuenta la segunda.

Consulta simple

Solo envía el número de su socio. VIES responde si es válido. No hay un identificador de la consulta, así que solo cuenta con su memoria o una captura de pantalla.

GET /check?vat_number=DE123456789
→ { "valid": true }
Esto es lo que hace VerifyVAT en cada solicitud

Consulta con solicitante

Indica además su propio NIF-IVA. VIES emite entonces un número de consulta para esa solicitud concreta. VerifyVAT envía su NIF-IVA automáticamente y guarda el número.

GET /check?vat_number=DE123456789
→ { "valid": true,
    "consultation_number": "WAPIAAAAZ4Kq8vDn" }

03

Cómo funciona

Del registro a la primera comprobación pasan unos minutos.

  1. 1

    Crear una cuenta

    Se registra con los datos de su empresa, incluido su propio NIF-IVA. Se envía a VIES como solicitante en cada comprobación; es la única forma de que VIES emita una prueba.

  2. 2

    Crear una clave

    En el panel genera una clave API por aplicación, por ejemplo tienda o ERP. Puede revocar una clave en cualquier momento.

  3. 3

    Enviar solicitudes

    Envía el NIF-IVA de su cliente a la API. La respuesta, el número de consulta y nuestro propio código de solicitud se guardan de inmediato.

04Para desarrolladores

Una solicitud, una respuesta

La API es una simple llamada GET con su clave en una cabecera. Recibe JSON con el resultado, los datos de la empresa según VIES y la prueba. Escriba el NIF-IVA del cliente con su prefijo de país, por ejemplo DE123456789.

  • Cada solicitud recibe un código único (VV-…), también las fallidas.
  • La cuota mensual y el límite por minuto se fijan por cuenta y se ven en el panel.
  • Si VIES no responde, recibe un 502 y el código de solicitud. Nada se notifica por error como válido.

Solicitud

curl "https://verifyvat.eu/api/v2/check?vat_number=DE123456789" \
  -H "apikey: vat_xxxxxxxx_xxxxxxxxxxxxxxxx"

Respuesta

{
  "request_code": "VV-3F9A1C2E",
  "valid": true,
  "query": "DE123456789",
  "company_name": "Muster GmbH",
  "company_address": "Musterstraße 1, 10115 Berlin",
  "consultation_number": "WAPIAAAAZ4Kq8vDn",
  "vies_request_date": "2026-10-11T01:14:09.000Z",
  "proof_available": true
}

Los campos de la respuesta

request_code
Su código de solicitud (VV-…). Se puede buscar en el panel.
valid
true si VIES da el número por válido; si no, false.
company_name / company_address
Nombre y dirección según VIES, si el Estado miembro los facilita.
consultation_number
El número de consulta de VIES. Es su prueba.
vies_request_date
Momento de la consulta según VIES.
proof_available
true si VIES emitió un número de consulta.

Códigos de estado

Un número no válido no es un error: obtiene 200 y valid: false.

200
Solicitud procesada, resultado en el campo valid.
400
Falta vat_number o su formato no es válido.
401
Falta la cabecera apikey, o la clave no es válida o fue revocada.
402
La cuota mensual está agotada.
403
Aún no hay un NIF-IVA propio guardado en la cuenta.
429
Se superó el límite por minuto. Espere un momento y reintente.
502
VIES no está disponible ahora. La solicitud queda guardada con su código.

05

Lo que ve en su cuenta

El panel está pensado para que pueda encontrar cualquier comprobación en segundos.

Historial

Todas las solicitudes con código, resultado, empresa, número de consulta y marca de tiempo. Búsqueda por código, NIF-IVA y número de consulta.

Exportación CSV

El historial completo en un archivo para contabilidad o inspecciones.

Comprobación manual

Valide un número a mano. Su empresa ya figura como solicitante.

Varias claves

Una clave por sistema, revocable por separado, para saber siempre de dónde vino una solicitud.

Uso

Cuota mensual usada y restante, límite por minuto y tasa de éxito de un vistazo.

Ayuda

Documentación con ejemplos y un formulario de soporte accesible desde cualquier página.

Para qué lo usan los equipos

Tienda online y pago

Valide el NIF-IVA en cuanto el cliente lo introduce al pagar y emita la factura en consecuencia.

ERP y contabilidad

Compruebe las nuevas cuentas de clientes al crearlas y revise su base con regularidad. Archive el número de consulta con el documento.

SaaS y alta de clientes

Verifique a los clientes empresa en el registro sin que nadie tenga que buscarlo a mano en una web oficial.

06Seguridad

Sus accesos y datos están protegidos

Nos confía accesos API y datos de empresa. Por eso se aplican estas reglas básicas:

Conexión cifrada

Todas las llamadas se hacen por HTTPS.

Claves API protegidas

Las claves se guardan cifradas y se pueden revocar una a una en cualquier momento.

Protección frente al abuso

El inicio de sesión y la API están limitados frente a intentos reiterados y sobrecarga.

Cuentas separadas

Cada cliente ve solo sus propias solicitudes y claves.

Términos en breve

NIF-IVA
Número de identificación a efectos del IVA. Empieza por un prefijo de país, por ejemplo ES para España, seguido del número.
VIES
El sistema de intercambio de información sobre el IVA de la Comisión Europea. Reenvía su consulta a la administración tributaria nacional.
Número de consulta
El identificador con el que VIES documenta una consulta que incluye solicitante.
Solicitante
Es usted: su propio NIF-IVA, enviado junto con la consulta.
Código de solicitud
El código corto VV-… de VerifyVAT. Es único por solicitud y se puede buscar en el panel.

Preguntas frecuentes

¿Por qué necesito mi propio NIF-IVA?+

VIES solo emite un número de consulta si se indica el solicitante. Sin un NIF-IVA guardado, la API no está activada.

¿Qué es el número de consulta?+

Es el identificador con el que VIES documenta una consulta que incluye solicitante. Lo conserva como prueba junto a sus justificantes.

¿De dónde proceden los datos?+

Todo procede de VIES, el servicio de la Comisión Europea. VerifyVAT no es una oferta de la Comisión Europea.

¿Qué países se comprueban?+

Los 27 Estados miembros de la UE y además Irlanda del Norte (XI). VIES no conoce números de Suiza, del Reino Unido ni de otros terceros países.

¿Qué significa «no válido»?+

VIES no da el número por válido en el momento de la consulta. Puede ser un error de escritura, un número aún no activado o dado de baja. En caso de duda, pregunte a su socio comercial.

¿Qué pasa si VIES no responde?+

La API responde con 502 y le da el código de solicitud. No se notifica nada como válido. Puede repetir la solicitud más tarde.

¿Puedo usarlo sin programar?+

Sí. El panel tiene un verificador manual, con su empresa ya indicada como solicitante.

¿Cuánto cuesta?+

Por ahora, nada. Su cuota aparece en su panel.

¿Listo para su primera comprobación?

Cree una cuenta, genere una clave y empiece. Solo lleva unos minutos.