{
"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/15160/gleif+lei+entity+verification+api/40441/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 Verificación de entidades LEI de GLEIF 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 en tiempo real los números de IVA europeos mediante EU VIES REST y consulta los Identificadores de Entidades Jurídicas (LEI) globales mediante GLEIF v1
Sí las comprobaciones del IVA consultan la API REST VIES de la Comisión Europea y los registros LEI consultan la API oficial GLEIF v1
El endpoint puede devolver un resultado de validación del IVA de la UE en tiempo real y/o resultados de búsqueda de GLEIF LEI La salida del IVA describe el número enviado y el estado de validación La salida LEI contiene registros coincidentes de entidades jurídicas encontrados por LEI o razón social
La validación del IVA abarca los números de IVA de los Estados miembros de la UE admitidos por VIES La consulta del LEI abarca los Identificadores de Entidades Jurídicas registrados a nivel mundial en los registros de GLEIF Una respuesta de IVA separa el código de país del número nacional de IVA, como «DE» y «129274202»
Las solicitudes pueden usar un número de IVA de la UE para la validación de VIES y pueden buscar en GLEIF por un LEI o por el nombre de una entidad legal Use la entrada adecuada para la operación deseada; la respuesta indica qué conjuntos de resultados se devolvieron
La respuesta JSON incluye un identificador de origen, un objeto `vatCheck`, `leiCount` y `leiRecords` `vatCheck` contiene detalles del IVA mientras que `leiRecords` contiene entidades GLEIF coincidentes `leiCount` indica el número de registros LEI devueltos
`vat` es el identificador enviado, `countryCode` es su prefijo de país de dos letras y `vatNumber` es la parte nacional. `isValid` es el resultado de la validación, `viesStatus` describe el resultado de la comprobación y `viesError` contiene un error cuando corresponda. `requestDate` registra la marca de tiempo de la solicitud.
`companyName` y `address` pueden proporcionar datos del registro cuando VIES los devuelve También pueden ser `null` incluso cuando `isValid` es `true` por lo que las aplicaciones deben basarse en `isValid` para determinar la validez y tratar los campos descriptivos como opcionales
Compruebe `leiCount` y `leiRecords`. Un recuento de `0` con una matriz vacía significa que ningún registro de GLEIF coincidió con el LEI o el nombre legal proporcionado. Las aplicaciones deben tratarlo como un resultado de búsqueda vacío en lugar de asumir que la solicitud falló.
El endpoint devuelve JSON estructurado Los clientes pueden leer el resultado del IVA en `vatCheck`, comprobar la validez con `isValid`, consultar los errores mediante `viesError` e iterar sobre `leiRecords` para encontrar coincidencias de entidades El `source` de nivel superior identifica el servicio combinado de IVA y LEI