{
"request_id": "a4cb6aeb4c9c5f97",
"iban": {
"input": "DE89370400440532013000",
"valid": true,
"iban": "DE89370400440532013000",
"iban_formatted": "DE89 3704 0044 0532 0130 00",
"country_code": "DE",
"check_digits": "89",
"bban": "370400440532013000",
"bank_code": "37040044",
"branch_code": null,
"account_number": "0532013000",
"sepa": true,
"bank": {
"bic": "COBADEFFXXX",
"name": "Commerzbank Köln"
},
"source": "offline",
"error": null,
"cached": true
},
"billable": false,
"usage": {
"plan": "zyla",
"used": 2,
"limit": null,
"remaining": null,
"reset_at": "2026-11-01T00:00:00.000Z",
"note": "Quota and billing for Zyla API Hub subscriptions are managed by Zyla API Hub, the marketplace you subscribed through."
}
}
curl --location --request POST 'https://zylalabs.com/api/14335/eu+vat+and+iban+validation+api/35930/validate+vat+and+iban' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"iban":"DE89370400440532013000"}'
{
"plan": "zyla",
"plan_name": "Zyla API Hub",
"price_usd_per_month": 0,
"monthly_quota": null,
"used": 2,
"remaining": null,
"period_start": "2026-10-01T00:00:00.000Z",
"reset_at": "2026-11-01T00:00:00.000Z",
"rate_limit_per_minute": 600,
"requests_this_month": 7,
"key_id": null,
"marketplace": "zyla",
"note": "Quota and billing for Zyla API Hub subscriptions are managed by Zyla API Hub, the marketplace you subscribed through."
}
curl --location --request GET 'https://zylalabs.com/api/14335/eu+vat+and+iban+validation+api/35931/usage+and+plan+status' --header 'Authorization: Bearer YOUR_API_KEY'
{
"ok": true,
"service": "vat-iban-api",
"time": "2026-10-18T23:45:55.174Z"
}
curl --location --request GET 'https://zylalabs.com/api/14335/eu+vat+and+iban+validation+api/35932/health+check' --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 e do IBAN 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. O teste gratuito inclui até 50 requisições.
Valide números VAT da UE via VIES e IBANs com busca de BIC. Armazenado em cache, à prova de falhas.
O endpoint de Validação de VAT e IBAN retorna resultados de validação para números de VAT da UE e IBANs, incluindo status de validade, IBAN formatado, código do país, detalhes do banco e mensagens de erro, se aplicável. O endpoint de Uso e Status do Plano fornece informações sobre o plano atual e métricas de uso, enquanto o endpoint de Verificação de Saúde indica o status do serviço e a versão
Os campos principais incluem "válido" (indicando validade), "iban_formatado" (IBAN formatado), "código_pais" (país do IBAN), "banco" (contendo BIC e nome do banco) e "erro" (quaisquer erros de validação) O endpoint de Uso inclui "usado" (chamadas feitas) e "reset_at" (data do próximo reset)
Os dados retornados estão estruturados em formato JSON Cada resposta contém objetos aninhados como "iban" para detalhes do IBAN e "usage" para informações do plano Esse formato estruturado permite uma fácil interpretação e integração em aplicações
O endpoint Validar VAT e IBAN fornece resultados de validação para números de VAT e IBAN, incluindo detalhes da empresa quando disponíveis O endpoint de Uso oferece informações sobre o uso da API enquanto o endpoint de Verificação de Saúde confirma a disponibilidade e o status do serviço
Envie uma solicitação POST com um corpo JSON contendo "vat" (número VAT da UE com seu prefixo de país de 2 letras, por exemplo DE123456789; use XI para a Irlanda do Norte) e/ou "iban" (por exemplo {"iban":"DE89370400440532013000"}). Você pode passar um ou ambos os campos em uma única solicitação
Os dados da resposta estão organizados em objetos principais, como "iban" para resultados de validação de IBAN e "uso" para métricas de uso da API. Cada objeto contém campos relevantes, facilitando o acesso a informações específicas como validade e detalhes bancários
Os dados do IVA vêm ao vivo do VIES (Sistema de Troca de Informações sobre o IVA) da UE, cobrindo todos os 27 estados membros da UE mais a Irlanda do Norte (XI); nome/endereço da empresa são retornados onde o estado membro os fornece. Os resultados são armazenados em cache por 24h e durante as falhas do VIES, um último resultado conhecido e bom é usado (ou válido:nulo com uma dica de nova tentativa). Os IBANs são validados fora
Casos de uso típicos incluem verificar a validade dos números de IVA para faturamento garantir a conformidade com as regulamentações fiscais e validar IBANs para transações financeiras seguras Isso ajuda as empresas a evitar erros na cobrança e nos pagamentos
Valid:null significa que o serviço VIES upstream para esse estado membro estava indisponível e não havia um resultado em cache (último conhecido como bom) para retornar. A resposta inclui uma sugestão de nova tentativa; por favor, tente novamente mais tarde. Não se trata de uma solicitação falhada e não significa que o número do IVA é inválido
Ainda não. A validação do IVA do Reino Unido (GB) através da HMRC estará disponível em breve. Os números de IVA da Irlanda do Norte (XI) já são suportados via VIES, junto com todos os 27 estados membros da UE