{
"source": "eu-vies-rest-and-gleif-lei-v1",
"vatCheck": {
"vat": "DE129274202",
"countryCode": "DE",
"vatNumber": "129274202",
"isValid": true,
"viesStatus": "ok",
"viesError": null,
"companyName": null,
"address": null,
"requestDate": "2026-11-21T06:50:58.176Z"
},
"leiCount": 0,
"leiRecords": []
}
curl --location --request GET 'https://zylalabs.com/api/15159/eu+vat+validation+vies+api/40440/verify+eu+vat+and+lookup+gleif+lei?vat=DE129274202' --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 del IVA de la UE VIES 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.
Verifica números de IVA europeos en tiempo real mediante la API REST VIES de la UE y consulta identificadores de entidades jurídicas (LEI) globales mediante GLEIF v1
Sí las verificaciones del IVA consultan la API REST VIES de la Comisión Europea y los registros LEI consultan la API oficial GLEIF v1
El objeto `vatCheck` incluye el identificador de IVA enviado, `countryCode`, `vatNumber` normalizado, el valor booleano `isValid`, `viesStatus`, cualquier `viesError`, los datos opcionales de la empresa y la marca de tiempo `requestDate`
El identificador completo aparece en `vat`, mientras que el prefijo del país y la parte numérica se separan en `countryCode` y `vatNumber`. Por ejemplo, `DE129274202` se devuelve como código de país `DE` y número `129274202`
`isValid` indica si el número de IVA de la UE enviado fue aceptado como válido por la solicitud de verificación VIES. Un valor de `true` confirma que la validación se realizó correctamente; consulta `viesStatus` y `viesError` para obtener más contexto
El endpoint admite búsquedas de LEI mediante un LEI exacto o búsquedas basadas en el nombre de una entidad jurídica. Los resultados coincidentes se devuelven en el array `leiRecords` y el número total se indica en `leiCount`
Los resultados de LEI se agrupan en el arreglo de nivel superior `leiRecords`. `leiCount` indica cuántos registros se devolvieron. Si ninguna entidad coincide con los criterios proporcionados, la API devuelve `leiCount: 0` y un arreglo `leiRecords` vacío.
Un array `leiRecords` vacío significa que no se devolvió ningún registro GLEIF coincidente para el LEI proporcionado o la búsqueda por nombre legal. Las aplicaciones deben tratar `leiCount: 0` como un resultado válido sin coincidencias en lugar de suponer que la respuesta está mal formada
Sí El endpoint puede proporcionar un objeto `vatCheck` y el resultado de búsqueda de LEI al mismo tiempo Esto permite que las aplicaciones validen un número de IVA europeo y también comprueben si existe un registro de entidad jurídica correspondiente
El endpoint devuelve un objeto JSON estructurado Incluye un identificador `source`, un objeto anidado `vatCheck` para la validación del IVA y `leiCount` junto con `leiRecords` para los resultados LEI Los campos que pueden ser nulos, como `companyName`, `address` o `viesError`, pueden contener `null` cuando no estén disponibles