API REST · 27 États membres

Un numéro de TVA. Toute la société. En un appel.

Vatlas transforme un numéro de TVA intracommunautaire en fiche société complète : raison sociale, identifiant national, forme juridique, statut et adresse. Les registres officiels sont importés chez nous, alors la réponse arrive en millisecondes — pas en secondes.

Tester l’API tout de suite Voir la documentation

Gratuit jusqu’à 100 requêtes / mois · 10 000 / mois pour 14 € HT · sans carte bancaire pour commencer.

~ curl vatlas.dev

$ curl "https://api.vatlas.dev/v1/vat/FR08000325175" \
    -H "Authorization: Bearer $VATLAS_KEY"

{
  "data": {
    "vatNumber": "FR08000325175",
    "countryCode": "FR",
    "nationalId": "000325175",
    "name": "THIERRY JANOYER",
    "legalForm": "1000",
    "status": "active",
    "address": {
      "line1": "51 RUE MARX DORMOY",
      "postalCode": "13004",
      "city": "MARSEILLE",
      "country": "FR"
    }
  },
  "meta": {
    "origin": "database",
    "source": "SIRENE",
    "checked": ["database"]
  }
}

États membres validés, plus l’Irlande du Nord

Sources nationales branchées, bulk ou à la demande

~40 ms

Réponse type quand la donnée est locale

Enveloppe JSON, quelle que soit la source

Bac à sable

Testez l’API, ici, maintenant

Collez un numéro ou cliquez sur un exemple. La réponse affichée est celle que renvoie l’API, à l’octet près.

Exemples :

Sous le capot

Rapide parce que la donnée est déjà là

VIES fait autorité, mais il est bien trop lent — et trop souvent indisponible — pour rester sur le chemin critique d’un tunnel de commande. Alors on ne l’interroge qu’en dernier recours.

Base locale

Une lecture indexée sur (country_code, vat_number) dans les registres nationaux importés en masse. C’est le cas courant, et il coûte quelques millisecondes.

API de la source

Pour les pays sans fichier bulk exploitable — la Pologne, par exemple — l’appel part vers l’administration, et la réponse est écrite en base. Le deuxième appel est local.

Repli VIES

Pour tout le reste, le service européen est interrogé puis mis en cache. Les fautes SOAP sont retentées : une indisponibilité n’est jamais lue comme un « non ».

Une seule enveloppe

Base locale, registre national ou VIES : le JSON est identique. meta.checked liste les sources réellement consultées, donc le client n’a jamais à deviner.

Validation hors ligne

Syntaxe des 27 États membres et clés de contrôle pour la France, la Finlande et la Pologne. Un numéro mal formé est rejeté en 2 ms, sans consommer de quota.

Erreurs qui veulent dire quelque chose

« Non enregistré à la TVA intracommunautaire » n’est pas « société inexistante », et « source indisponible » n’est pas un résultat négatif. Trois codes distincts.

Couverture

Toute l’Union, huit sources en propre

Les numéros des 27 États membres sont validés et résolus. Huit pays sont servis directement depuis leur registre officiel, importé ou interrogé chez nous.

source importée api officielle repli vies

Pays servis depuis leur registre national
Pays	Source	Stratégie	Ce que ça change
Belgique `BE`	Données ouvertes KBO / BCE	bulk	Le numéro de TVA est le numéro d’entreprise : 1,9 M d’entités, clé directe.
Tchéquie `CZ`	ARES (ministère des Finances)	api	ARES publie le DIČ lui-même : un appel résout le numéro.
Estonie `EE`	e-Business Register (RIK)	bulk	Le numéro de TVA figure directement dans le fichier bulk quotidien.
Finlande `FI`	PRH open data	bulk api	Registre du commerce complet, plus l’API pour les sociétés cessées.
France `FR`	INSEE SIRENE	bulk	Des millions d’unités légales en base, adresses incluses.
Lettonie `LV`	Registre + VID (CC0)	bulk	Registre des assujettis joint au registre des entreprises.
Pologne `PL`	White List du ministère des Finances	api	Résolu à la demande à la première requête, puis servi depuis le cache.
Roumanie `RO`	Registre des contribuables ANAF	api	L’ANAF renvoie l’identité, le siège et le statut TVA par CUI.

FR France

FI Finlande

EE Estonie

LV Lettonie

PL Pologne

DE Allemagne

AT Autriche

BE Belgique

BG Bulgarie

CY Chypre

HR Croatie

DK Danemark

ES Espagne

EL Grèce

HU Hongrie

IE Irlande

IT Italie

LT Lituanie

LU Luxembourg

MT Malte

NL Pays-Bas

PT Portugal

CZ Tchéquie

RO Roumanie

SK Slovaquie

SI Slovénie

SE Suède

XI Irlande du Nord

Cas d’usage

Là où ça vous fait gagner du temps

Facturation B2B

Vérifiez l’assujettissement avant d’appliquer l’autoliquidation, et remplissez la facture avec la raison sociale exacte du registre.

KYB & conformité

Rattachez un client à son identifiant national et à son statut, avec l’horodatage de la source pour votre piste d’audit.

Onboarding

Un champ, un appel, un formulaire pré-rempli. Vous supprimez cinq champs de saisie et les fautes de frappe qui vont avec.

Enrichissement CRM

Rejouez votre base de comptes pour normaliser les raisons sociales, les adresses et repérer les sociétés inactives.