ApivomApivom
Demander une démo

API de validation de TVA de l’UE

Une interface REST gratuite, prête pour la production, au-dessus du service officiel VIES de l’UE. Validez n’importe quel numéro de TVA de l’UE en un seul appel HTTP : réponses JSON, cache en périphérie, limites de débit raisonnables et journaux d’audit conformes au RGPD.

API publique · Offre gratuite

Source VIES officielle

Adossée à ec.europa.eu/taxation_customs/vies, le registre de référence de l’UE. Un cache transparent de 24 h en périphérie réduit la latence sans données périmées.

Du JSON, pas du SOAP

VIES expose du SOAP ; nous l’encapsulons dans une API REST + JSON propre pour une intégration en quelques minutes, sans se battre avec des WSDL.

Limites de débit et anonymat

Niveau anonyme : 3 recherches par IP et par jour. Vérifiez votre e-mail pour 5 vérifications par IP et par jour. Des niveaux supérieurs sont proposés aux partenaires.

Conforme au RGPD

Les adresses IP sont hachées (SHA-256) avant journalisation. Aucune donnée personnelle conservée dans le parcours anonyme.

Éprouvée en production

Elle alimente en production l’outil public /tools/eu-business-lookup. Même code, mêmes garanties de disponibilité.

Aucune inscription pour essayer

Appelez directement le point de terminaison public pour l’évaluer. Besoin de limites plus élevées ou de webhooks ? Contactez-nous pour le niveau partenaire.

Points de terminaison

Tous les points de terminaison acceptent et renvoient du JSON. Les erreurs suivent la RFC 7807 (problem+json).

URL de base: https://atlas.apivom.com

POST/eu-vat/lookup

Valide un pays et un numéro de TVA. Renvoie des données d’entreprise masquées au niveau anonyme.

POST/eu-vat/verify

Confirme un jeton e-mail issu du double opt-in. Débloque l’enregistrement complet, non masqué.

POST/eu-vat/resend

Renvoie l’e-mail de confirmation si l’utilisateur l’a perdu. Soumis au même plafond quotidien par IP.

Démarrage rapide

Trois étapes jusqu’à votre premier numéro de TVA validé.

  1. Consultez la liste des points de terminaison

    Chaque point de terminaison est listé ci-dessus avec sa méthode et son chemin. L’exemple curl ci-dessous montre une requête complète.

  2. Envoyez une requête de recherche

    Envoyez country_code + vat_number en POST à /eu-vat/lookup. Vous obtenez aussitôt un résultat masqué et un identifiant de recherche.

  3. Vérifiez l’e-mail pour tout afficher

    Double opt-in facultatif : recueillez l’e-mail de l’utilisateur, envoyez la confirmation, puis appelez /eu-vat/verify avec le jeton pour révéler toutes les données de l’entreprise.

curl -X POST 'https://atlas.apivom.com/eu-vat/lookup' \
  -H 'Content-Type: application/json' \
  -d '{ "country_code": "IE", "vat_number": "3515583EH" }'

Questions fréquentes.

Est-ce vraiment gratuit ?

Oui : le niveau anonyme est gratuit pour un usage occasionnel (3 recherches par IP et par jour). Pour des volumes plus importants, des points de terminaison partenaires avec clés d’API sont disponibles sur demande.

Les données sont-elles à jour ?

VIES est interrogé en temps réel ; les réponses valides sont mises en cache en périphérie pendant 24 heures pour protéger à la fois votre application et le service source.

Conservez-vous les numéros de TVA que je vérifie ?

Nous conservons les recherches validées (code pays, numéro de TVA, validité, horodatage) à des fins d’audit. Les adresses IP sont hachées avant journalisation. Nous ne conservons AUCUNE donnée personnelle pour les appels anonymes.

Pourquoi le nom de l’entreprise est-il masqué ?

Pour empêcher l’extraction automatisée du registre, les réponses anonymes masquent en partie le nom et l’adresse. Vérifiez votre e-mail pour recevoir l’enregistrement complet.

Que se passe-t-il si VIES est indisponible ?

Vous recevez une erreur 503 explicite. Nous n’inventons jamais de données quand le service source est injoignable.

Puis-je obtenir une clé partenaire ?

Oui. Écrivez-nous via la page de contact en précisant votre volume prévu et votre cas d’usage.