French intra-community VAT number API - European Commission | API Entreprise bundleAPI N°TVA intracommunautaire français - Commission européenne | Bouquet API Entreprise
API N°TVA intracommunautaire français - Commission européenne | Bouquet API EntrepriseFrench intra-community VAT number API - European Commission | API Entreprise bundle
This API provides the French intra-community VAT number, verified against the European Commission's VIES system. It is part of the API Entreprise bundle, a set of services operated by Etalab that allow public administrations and authorized partners to retrieve official business data to simplify administrative procedures and avoid requesting documents already held by the government. Access requires an API key, and the service is intended for French institutional and business use cases involving VAT number verification for companies.> L'[API N°TVA intracommunautaire français - Commission européenne | Bouquet API Entreprise](https://entreprise.api.gouv.fr/catalogue/commission_europeenne/numero_tva) permet d'obtenir le **numéro de TVA intracommunautaire français, vérifié auprès de la Commission européenne**. ➡️ **Cette API fai…
Trust score
How is this computed?Weighted across five axes. Tap a ring for what it measures.
Data schema (16 fields)
| Field | Type | Description |
|---|---|---|
| provider | string | Provider identifier as returned by /pings.Identifiant du fournisseur (tel que retourné par `/pings`) |
| recipient | string | SIRET of the administration receiving the data."**Bénéficiaire de l’appel** SIRET de l’administration destinatrice des données." |
| delegation_idDelegation id | string | UUID identifying a specific publisher delegation, for publisher tokens."**Identifiant de la délégation éditeur** UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)." |
| context | string | Context or purpose of the request, e.g. public aid or procurement."**Cadre de la requête** Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application." |
| object | string | Reason for the call or an identifier used to trace the request."**La raison de l’appel ou l’identifiant de la procédure.** L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous deve |
| siretSIRET (establishment) | string | SIRET number identifying the establishment.Siret de l'établissement |
| limit | number | Maximum number of results to return, between 1 and 1000.Limite le nombre de résultats retournés. Valeur entre 1 et 1000 (Défault 1000) |
| sirenSIREN (company) | string | SIREN number identifying the company.SIREN number identifying the company. |
| siren_or_siret_or_rnaSiren or siret or rna | string | SIREN, SIRET or RNA number of the association whose grants are requested.Siren, Siret ou RNA de l'association dont vous souhaitez obtenir les subventions. |
| siret_or_eoriSiret or eori | string | SIRET or EORI number identifying the company.Siret ou numéro EORI de l'entreprise |
| year | integer | Reference year for the requested data.Reference year for the requested data. |
| siren_or_rnaSiren or rna | string | SIREN number of the association or its RNA number.Siren de l'association ou le numéro RNA |
| nature_effectifNature effectif | string | Type of workforce figure returned, e.g. average annual headcount.Indique la nature de l'effectif transmis. Si ce paramètre n'est pas complété en appel, l'effectif moyen annuel (EMA) sera renvoyé par défaut. L'API permet d'accéder à 4 natures d'effectif : - Effectif moyen annuel (EMA), c'est-à-dire le nombre de salariés en contrat 'actif' hors exclusions. Ces e |
| month | string | Reference month for the workforce data, formatted 01 to 12.Mois de référence des effectifs (format: 01 à 12). |
| profondeur | integer | Number of prior months of workforce data to return, up to 13.Nombre de mois à renvoyer, en amont de la date choisie. Ce paramètre permet de renvoyer les effectifs de plusieurs mois en même temps, antérieurs à la date choisie, et au maximum 13 mois. Par exemple si la date indiquée est 03/2025 et ce paramètre de profondeur est 3. Les effectifs de janvier, févri |
| errorsError | array<object> | List of errors returned by the API call.List of errors returned by the API call. |
Schema captured from openapi 1 month ago.
Verification Status
Using the API
Configuration
- Base URL
- https://entreprise.api.gouv.fr
- Format
- openapi
Query examples
Stored only in this browser. Runs go directly from your browser to the API — the key is never sent through our servers.
curl -s 'https://entreprise.api.gouv.fr/open-api-without-deprecated-paths.yml' -H 'Accept: application/json'Machine-readable API description (use it to generate clients).
Machine-readable & source
Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.