{
"input": "IE6388047V",
"country": "IE",
"vat_number": "6388047V",
"valid": true,
"name": "GOOGLE IRELAND LIMITED",
"address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
"checked_at": "2026-11-20T10:47:47.744Z",
"source": "European Commission VIES"
}
curl --location --request GET 'https://zylalabs.com/api/15111/eu+vat+number+validator+api/40162/validate+an+eu+vat+number?vat=IE6388047V' --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 Validador de Número de IVA da UE 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.
Valide os números de IVA da UE contra o serviço VIES da Comissão Europeia e obtenha o nome e endereço registrados
Comissão Europeia VIES
Estados membros da UE e Irlanda do Norte apenas Registros nacionais às vezes estão offline O API então retorna HTTP 503
Envie um número de IVA da UE para o endpoint de validação. O serviço identifica o prefixo do país e valida o número de IVA nacional restante através do VIES. Por exemplo, `IE6388047V` é analisado como país `IE` e número de IVA `6388047V`
A resposta inclui o `input` original, o `country` analisado, o `vat_number` e um resultado booleano `valid`. Quando fornecidos pelo estado-membro, também inclui o `name` e o `address` registrados, além dos metadados `checked_at` e `source`
`valid: true` significa que o VIES confirmou o número de IVA enviado junto ao registo nacional relevante. `valid: false` significa que o número não foi confirmado. Trate o resultado como uma resposta de validação para o valor enviado, não como prova da situação jurídica ou financeira mais ampla de uma empresa.
`country` contém o código de país de duas letras, como `IE` para a Irlanda. `vat_number` contém o identificador nacional de IVA sem o prefixo do país. O campo `input` preserva o valor completo enviado para validação.
Não. `name` e `address` são retornados quando o Estado-Membro em questão compartilha esses dados por meio do VIES. Eles podem estar vazios ou indisponíveis mesmo quando um número de IVA é validado com sucesso, portanto, os aplicativos devem lidar com campos ausentes.
O endpoint retorna um objeto JSON estruturado contendo campos escalares, como strings e o booleano `valid`. Uma resposta típica inclui valores como `"country": "IE"`, `"valid": true` e `"name": "GOOGLE IRELAND LIMITED"`
`checked_at` registra quando o resultado da validação foi verificado, usando um carimbo de data e hora ISO 8601 em UTC, como `2026-11-20T10:47:47.744Z`. Isso ajuda os aplicativos a associar a resposta a um evento de verificação específico
Use o resultado para verificar identificadores de IVA durante o cadastro de clientes, faturamento, fluxos de trabalho fiscais ou verificações de registros comerciais Armazene `valid` junto com os dados enviados e o registro de data e hora e use o nome e o endereço retornados para correspondência ou exibição quando esses campos estiverem disponíveis