N°TVA intracommunautaire français Déprécié
Numéro de TVA intracommunautaire français, vérifié auprès de la Commission européenne. API incluse par défaut
Commission européenne
Cette API est dépréciée
Cette API est une ancienne version, nous vous invitons à utiliser ces API les plus récentes :
Plus d'informations sur la gestion de version API Entreprise dans cette documentation.
Périmètre
Entreprises ou associations concernées :
Cette API concerne uniquement les ✅ unités légales ayant un numéro de TVA intracommunautaire français.
❌ Cette API ne délivre pas les numéros de TVA d’un autre pays européen.
Une unité légale répertoriée en France peut ne pas avoir de numéro de TVA français si son siège était historiquement à l’étranger et avait commencé à déclarer ses impôts dans ce pays. Dans ce cas, l’unité légale garde le numéro de TVA qui lui a été délivré par ce pays européen. Ce numéro de TVA n’est alors pas délivré par cette API.
Périmètre géographique :
❌ Les unités légales immatriculées dans les DROM COM français ne peuvent pas avoir de numéro de TVA intracommunautaire car elles ne font pas partie du territoire communautaire en matière de TVA en vertu de l’article 6 de la Directive europénne de TVA.
Actualisation de la donnée :
Les numéros de TVA sont délivrés et vérifés en temps réel.
En savoir plus :
- Site officiel de la Commission Européenne sur le service VIES
- Définition d’un Numéro de TVA intracommunautaire par Service-Public.fr
- Fichier plat DGFIP sur data.gouv.fr : Liste des entreprises bénéficiaires du traitement TVA — pour les traitements en volume, ce fichier peut être utilisé directement sans passer par l’API (ni quotas, ni temps réel, fraîcheur J+1)
Cas d'usages
Fiches pratiques et cas d'usages pour lesquels l'API est utile :
Détails de l'API
Format de l'information
- Donnée structurée JSON
Identifiant d'appel
- Numéro de SIREN de l'unité légale
Disponibilité
Limite d'appels
(partagé entre API du groupe)
Les données
Cette API génère le numéro de TVA d’une unité légale à partir de son numéro de SIREN et vérifie auprès du service VIES de la Commission Européenne que celui-ci est valide.
⚠️ Si l’API ne retourne pas de numéro de TVA, cela ne veut pas dire que l’unité légale n’a pas de numéro de TVA. En effet, celle-ci peut avoir un numéro de TVA non français.
Informations renvoyées en JSON :
Erreurs
Lorsque cette API ne peut pas retourner les informations demandées, elle renvoie un code erreur. Les erreurs communes à toutes les API (jeton, paramètres obligatoires, quotas) sont décrites dans la nomenclature des codes erreurs ; celles qui suivent sont celles que cet endpoint peut renvoyer, y compris les erreurs génériques de son fournisseur de données.
Cette liste est aussi servie au format JSON, sans jeton, sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_european_commission_vies.
| Code | Signification |
|---|---|
00301 |
Entité non traitable
Le numéro de siren n'est pas correctement formatté |
| Code | Signification |
|---|---|
28003 |
Entité non trouvée
Le ou les paramètre(s) d'entrée n'existent pas, ne sont pas connus, ou ne comportent aucune information pour cet appel. Veuillez vérifier que votre recherche est couverte par le périmètre de l'API. |
| Code | Signification |
|---|---|
28000 |
Erreur interne du fournisseur de données
La réponse retournée par le fournisseur de données est invalide et a été identifié comme étant une erreur interne. Si le problème persiste, consultez la page de status ou contactez nous sur le support. |
28001 |
Service non disponible
Service du fournisseur de données temporairement indisponible ou en maintenance. |
28004 |
Erreur de résolution DNS
Problème de résolution DNS de l'adresse du serveur |
28008 |
Erreur auprès du fournisseur de données : trop de requêtes
Erreur de fournisseur de donnée : Trop de requêtes effectuées, veuillez réessayer plus tard. |
28009 |
Erreur de connexion sécurisée (TLS) avec le fournisseur de données
La connexion sécurisée avec le fournisseur de données n'a pas pu être établie : certificat invalide ou expiré, ou échec de la négociation TLS. L'équipe technique a été notifiée de cette erreur pour investigation. |
28011 |
Erreur temporaire du fournisseur de données
Merci de réessayer dans quelques instants |
28999 |
Erreur inconnue du fournisseur de données
La réponse retournée par le fournisseur de données est invalide et inconnue de notre service. L'équipe technique a été notifiée de cette erreur pour investigation. |
| Code | Signification |
|---|---|
28020 |
Maintenance du fournisseur de données
Le fournisseur de données semble être en maintenance |
| Code | Signification |
|---|---|
28002 |
Intermédiaire hors-délai
Temps d’attente d’une réponse du fournisseur de données écoulé. |
Questions & réponses
Dans la majorité des cas, il est assez simple de déduire le numéro de TVA à partir du numéro de SIREN. C’est pourquoi, beaucoup de sites tiers effectuent ce calcul et affichent le potentiel numéro de TVA, sans effectuer de vérification. De fait, dans certains cas, le numéro de TVA que ces sites tiers proposent est faux.
Dans le cas où l’API Entreprise ne délivre pas de numéro de TVA (erreur de type 404 - entité non-trouvée) pour un SIREN dont vous avez obtenu le numéro de TVA par un site tiers, il est fort probable que ce numéro de TVA est invalide. En effet, l’API Entreprise effectue une vérification auprès du site officiel de la Commission Européenne sur le service VIES.
Si vous avez un doute, vous pouvez vérifier vous-même le numéro de TVA à partir du service VIES.
Historique
Juin 2025 : dépréciation de cet endpoint
Cet endpoint est remplacé par DGFIP : Numéro de TVA, qui s’appuie sur les extractions publiées par la DGFIP sur data.gouv.fr et suit la même stratégie de vérification. Nous vous recommandons d’utiliser le nouvel endpoint.
Conditions d'utilisation des données
Utilisation possible de la donnée :
Conditions générales :
Cette API et l'utilisation de ses données est soumise aux CGU générales d'API Entreprise, dont voici les principaux éléments auxquels vous vous engagez :
- ne demander que les données strictement nécessaires ;
- ne pas utiliser votre jeton d'accès pour une démarche différente de celle indiquée lors de votre demande (le cas échéant le jeton sera révoqué) ;
- présenter les données obtenues uniquement aux seuls agents habilités et à tracer l'accès de ces agents aux données ;
- ne pas commercialiser les données reçues et à ne pas les communiquer à des tiers en dehors des cas prévus par la loi.
L'ensemble des conditions sont consultables et téléchargeables ci-dessous :
CGU API EntrepriseCas d'usages
Fiches pratiques et cas d'usages pour lesquels l'API est utile :
Détails de l'API
Format de l'information
- Donnée structurée JSON
Identifiant d'appel
- Numéro de SIREN de l'unité légale
Disponibilité
Limite d'appels
(partagé entre API du groupe)