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 gratuiteSource 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
Valide un pays et un numéro de TVA. Renvoie des données d’entreprise masquées au niveau anonyme.
Confirme un jeton e-mail issu du double opt-in. Débloque l’enregistrement complet, non masqué.
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é.
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.
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.
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" }'const res = await fetch('https://atlas.apivom.com/eu-vat/lookup', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ country_code: 'IE', vat_number: '3515583EH' }),
});
const data = await res.json();
console.log(data);import requests
resp = requests.post(
'https://atlas.apivom.com/eu-vat/lookup',
json={'country_code': 'IE', 'vat_number': '3515583EH'},
timeout=10,
)
print(resp.json())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.