{
"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'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Validação do IVA da UE VIES API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento.
Verifique números de IVA europeus em tempo real via EU VIES REST e consulte identificadores globais de entidades jurídicas (LEI) via GLEIF v1
Sim, as verificações de IVA consultam a API REST VIES da Comissão Europeia e os registros LEI consultam a API oficial GLEIF v1
O objeto `vatCheck` inclui o identificador de IVA enviado, `countryCode`, o `vatNumber` normalizado, o valor booleano `isValid`, `viesStatus`, qualquer `viesError`, os dados opcionais da empresa e o carimbo de data e hora `requestDate`
O identificador completo aparece em `vat`, enquanto o prefixo do país e a parte numérica são separados em `countryCode` e `vatNumber`. Por exemplo, `DE129274202` é retornado como código do país `DE` e número `129274202`
`isValid` indica se o número de IVA da UE enviado foi aceito como válido pela solicitação de verificação do VIES. Um valor de `true` confirma um resultado de validação bem-sucedido; consulte `viesStatus` e `viesError` para obter contexto adicional
O endpoint oferece suporte a consultas de LEI por um LEI exato ou a pesquisas com base no nome de uma entidade jurídica. Os resultados correspondentes são retornados no array `leiRecords`, com o número total informado por `leiCount`
Os resultados de LEI são agrupados no array de nível superior `leiRecords`. `leiCount` informa quantos registros foram retornados. Se nenhuma entidade corresponder aos critérios fornecidos, a API retorna `leiCount: 0` e um array `leiRecords` vazio
Um array `leiRecords` vazio significa que nenhum registro GLEIF correspondente foi retornado para a pesquisa pelo LEI ou nome legal fornecido. As aplicações devem tratar `leiCount: 0` como um resultado válido sem correspondências, em vez de presumir que a resposta está malformada.
Sim O endpoint pode fornecer um objeto `vatCheck` e os resultados da pesquisa de LEI juntos Isso permite que os aplicativos validem um número de IVA europeu e também verifiquem se há um registro correspondente de entidade jurídica
O endpoint retorna um objeto JSON estruturado. Ele inclui um identificador `source`, um objeto `vatCheck` aninhado para a validação do IVA e `leiCount` mais `leiRecords` para os resultados LEI. Campos anuláveis como `companyName`, `address` ou `viesError` podem conter `null` quando não estiverem disponíveis