Pular para o conteúdo principal

​
Endpoint

POST https://api.bunny.build/api/v1/vat-validator

​
Autenticação

HeaderObrigatórioValor
X-API-KeySimSua chave de API (bun_...)
Content-TypeSimapplication/json

​
Visão geral

Valide números de IVA da União Europeia no banco de dados oficial do VIES (Sistema de Troca de Informações sobre IVA) e recupere a razão social e o endereço registrado da empresa. Use esta API para automatizar verificações de conformidade fiscal B2B e manter seus dados de faturamento precisos.

​
Casos de uso

  • Verificar números de IVA de clientes durante o checkout B2B
  • Preencher automaticamente razão social e endereço a partir de um número de IVA
  • Condicionar a isenção de imposto à confirmação de IVA válido
  • Detectar números de IVA fraudulentos ou expirados

​
Detalhes

Cobre todos os estados-membros da UE. O campo vat deve incluir o prefixo de dois letras do país (ex.: DE123456789, FR12345678901). A validação consulta o serviço VIES em tempo real; eventuais timeouts do sistema VIES são propagados como erros.

​
Corpo da requisição

CampoTipoObrigatórioDescrição
vatstringSimNúmero de IVA incluindo prefixo do país (ex.: DE123456789)

​
Exemplo

{
  "vat": "DE123456789"
}

​
Resposta

​
200 OK

CampoTipoDescrição
validbooleanSe o número de IVA está registrado e ativo
vatstringNúmero de IVA normalizado
countrystringCódigo de país ISO
namestringRazão social registrada
addressstringEndereço registrado da empresa
Exemplo 
{
  "valid": true,
  "vat": "DE123456789",
  "country": "DE",
  "name": "Example GmbH",
  "address": "Musterstraße 1, 10115 Berlin"
}

​
401 Unauthorized

{
  "detail": "Missing API key. Include X-API-Key header."
}

​
402 Payment Required

{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}

​
422 Unprocessable Entity

{
  "detail": "Invalid VAT number format"
}

​
429 Too Many Requests

{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}

​
Exemplo cURL

curl -X POST https://api.bunny.build/api/v1/vat-validator \
  -H "X-API-Key: bun_sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{"vat": "DE123456789"}'