{
"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'
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 Verificação de entidade LEI da GLEIF 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 REST do VIES da UE e consulte Identificadores de Entidades Jurídicas (LEI) globais 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 endpoint pode retornar um resultado de validação de IVA da UE em tempo real e/ou resultados de pesquisa de LEI da GLEIF A saída do IVA descreve o número enviado e o status da validação A saída de LEI contém registros de entidades jurídicas correspondentes encontrados por LEI ou nome jurídico
A validação do IVA abrange números de IVA dos Estados-Membros da UE suportados pelo VIES. A consulta de LEI abrange Identificadores de Entidades Jurídicas registados globalmente nos registos da GLEIF. Uma resposta de IVA separa o código do país do número nacional de IVA, como “DE” e “129274202”
As solicitações podem usar um número de IVA da UE para validação no VIES e podem pesquisar no GLEIF por um LEI ou pelo nome de uma entidade jurídica Use a entrada apropriada para a operação desejada; a resposta indica quais conjuntos de resultados foram retornados
A resposta JSON inclui um identificador de origem um objeto `vatCheck` `leiCount` e `leiRecords` `vatCheck` contém detalhes do IVA enquanto `leiRecords` contém entidades GLEIF correspondentes `leiCount` informa o número de registros LEI retornados
`vat` é o identificador enviado, `countryCode` é o prefixo de duas letras do país, e `vatNumber` é a parte nacional. `isValid` é o resultado da validação, `viesStatus` descreve o resultado da verificação, e `viesError` contém um erro quando aplicável. `requestDate` registra o carimbo de data e hora da solicitação.
`companyName` e `address` podem fornecer dados do registro quando retornados pelo VIES. Eles também podem ser `null`, mesmo quando `isValid` é `true`, portanto, os aplicativos devem se basear em `isValid` para determinar a validade e tratar os campos descritivos como opcionais.
Verifique `leiCount` e `leiRecords` Uma contagem de `0` com uma matriz vazia significa que nenhum registro GLEIF correspondeu ao LEI ou nome legal fornecido Os aplicativos devem tratar isso como um resultado de pesquisa vazio em vez de presumir que a solicitação falhou
O endpoint retorna JSON estruturado Os clientes podem ler o resultado do IVA em `vatCheck` testar a validade com `isValid` inspecionar os erros por meio de `viesError` e iterar sobre `leiRecords` para encontrar correspondências de entidades O `source` de nível superior identifica o serviço combinado de IVA e LEI