API de vérification des numéros de TVA

Vérifier, et pouvoir le prouver.

VerifyVAT interroge en direct VIES pour les numéros de TVA de vos partenaires et conserve à chaque contrôle le numéro de consultation officiel. Vous pouvez ainsi montrer plus tard que vous avez vérifié, et quand.

S’inscrire gratuitement Se connecter

Les nouveaux comptes démarrent avec 1 000 requêtes par mois.

Justificatif de contrôleExemple

Code de requête: VV-3F9A1C2E
N° de TVA vérifié: DE123456789
Résultat: valide
Société (selon VIES): Muster GmbH
Demandeur: LU32633157
Horodatage: 2026-10-11 01:14:09

Numéro de consultation (VIES)

WAPIAAAAZ4Kq8vDn

Conservé dans votre compte, consultable dans l’historique et en CSV.

prouvé

27 + XI: États membres de l’UE et Irlande du Nord, couverts via VIES
VV-…: Un code de requête unique pour chaque contrôle
Preuve: Le numéro de consultation officiel est conservé à chaque requête
CSV: Historique complet en export pour la comptabilité et les contrôles

01Pourquoi vérifier ?

Un numéro de TVA valide détermine souvent le traitement fiscal

Quand vous vendez à des entreprises d’autres pays de l’UE, vous devez savoir à qui vous avez affaire. Le numéro de TVA du partenaire est l’identifiant clé, et sa validité peut évoluer.

Livraisons exonérées

Les livraisons intracommunautaires à des entreprises d’un autre État de l’UE ne sont en principe exonérées que si le client utilise un numéro de TVA valide. Sans justificatif, vous risquez un redressement.

Autoliquidation des prestations

Pour de nombreux services B2B, le preneur est redevable de la taxe. Le contrôle montre que votre client est enregistré comme entreprise avant de facturer sans TVA.

Preuve lors d’un contrôle fiscal

L’administration peut demander plus tard si et quand vous avez vérifié. Avec le code de requête, l’horodatage et le numéro de consultation, vous avez une réponse sans devoir reconstituer quoi que ce soit.

Ceci n’est pas un conseil fiscal. Les justificatifs nécessaires dans votre cas sont à clarifier avec votre conseiller fiscal.

02Simple ou qualifiée

La différence entre « valide » et « prouvé »

VIES connaît deux types de requêtes. Pour la documentation, c’est la seconde qui compte.

Requête simple

Vous envoyez uniquement le numéro de votre partenaire. VIES indique s’il est valide. Il n’y a aucun identifiant pour la requête : vous n’avez que votre mémoire ou une capture d’écran.

GET /check?vat_number=DE123456789
→ { "valid": true }

C’est ce que fait VerifyVAT à chaque requête

Requête avec demandeur

Vous indiquez en plus votre propre numéro de TVA. VIES émet alors un numéro de consultation pour cette requête précise. VerifyVAT transmet automatiquement votre numéro de TVA et conserve ce numéro.

GET /check?vat_number=DE123456789
→ { "valid": true,
    "consultation_number": "WAPIAAAAZ4Kq8vDn" }

Fonctionnement

De l’inscription au premier contrôle, il suffit de quelques minutes.

1
Créer un compte
Vous vous inscrivez avec les données de votre entreprise, y compris votre propre numéro de TVA. Il est transmis à VIES comme demandeur à chaque contrôle ; c’est la seule façon pour VIES d’émettre une preuve.
2
Créer une clé
Dans le tableau de bord, vous générez une clé API par application, par exemple boutique ou ERP. Vous pouvez révoquer une clé à tout moment.
3
Envoyer des requêtes
Vous envoyez le numéro de TVA de votre client à l’API. La réponse, le numéro de consultation et notre propre code de requête sont enregistrés immédiatement.

04Pour les développeurs

Une requête, une réponse

L’API est un simple appel GET avec votre clé dans un en-tête. Vous recevez du JSON avec le résultat, les données de l’entreprise selon VIES et la preuve. Saisissez le numéro de TVA du client avec son préfixe pays, par exemple DE123456789.

Chaque requête reçoit un code unique (VV-…), y compris en cas d’échec.
Le quota mensuel et la limite par minute sont définis par compte et visibles dans le tableau de bord.
Si VIES est injoignable, vous recevez un 502 et le code de requête. Rien n’est signalé à tort comme valide.

Requête

curl "https://verifyvat.eu/api/v2/check?vat_number=DE123456789" \
  -H "apikey: vat_xxxxxxxx_xxxxxxxxxxxxxxxx"

Réponse

{
  "request_code": "VV-3F9A1C2E",
  "valid": true,
  "query": "DE123456789",
  "company_name": "Muster GmbH",
  "company_address": "Musterstraße 1, 10115 Berlin",
  "consultation_number": "WAPIAAAAZ4Kq8vDn",
  "vies_request_date": "2026-10-11T01:14:09.000Z",
  "proof_available": true
}

Les champs de la réponse

request_code: Votre code de requête (VV-…). Recherchable dans le tableau de bord.
valid: true si VIES considère le numéro comme valide, sinon false.
company_name / company_address: Nom et adresse selon VIES, si l’État membre les fournit.
consultation_number: Le numéro de consultation de VIES. C’est votre preuve.
vies_request_date: Date et heure de la requête selon VIES.
proof_available: true si VIES a émis un numéro de consultation.

Codes d’état

Un numéro invalide n’est pas une erreur : vous obtenez 200 et valid: false.

200: Requête traitée, résultat dans le champ valid.
400: vat_number est absent ou son format est invalide.
401: L’en-tête apikey est absent, ou la clé est invalide ou révoquée.
402: Le quota mensuel est épuisé.
403: Aucun numéro de TVA propre n’est encore enregistré dans le compte.
429: La limite par minute est dépassée. Patientez brièvement et réessayez.
502: VIES est actuellement injoignable. La requête est conservée avec son code.

Ce que vous voyez dans votre compte

Le tableau de bord est conçu pour retrouver chaque contrôle en quelques secondes.

Historique

Toutes les requêtes avec code, résultat, société, numéro de consultation et horodatage. Recherche par code, numéro de TVA et numéro de consultation.

Export CSV

L’historique complet sous forme de fichier pour la comptabilité ou un contrôle.

Contrôle manuel

Vérifiez un numéro à la main. Votre entreprise est déjà renseignée comme demandeur.

Plusieurs clés

Une clé par système, révocable individuellement, pour toujours savoir d’où vient une requête.

Utilisation

Quota mensuel utilisé et restant, limite par minute et taux de réussite en un coup d’œil.

Aide

Une documentation avec exemples et un formulaire d’assistance accessible depuis chaque page.

À quoi les équipes l’utilisent

Boutique en ligne et paiement

Vérifiez le numéro de TVA dès que le client le saisit au paiement et établissez la facture en conséquence.

ERP et comptabilité

Contrôlez les nouveaux comptes clients à leur création et revérifiez régulièrement votre fichier. Classez le numéro de consultation avec la pièce.

SaaS et onboarding

Vérifiez les clients professionnels à l’inscription, sans que personne n’ait à chercher manuellement sur un site officiel.

06Sécurité

Vos accès et vos données sont protégés

Vous nous confiez des accès API et des données d’entreprise. Ces règles de base s’appliquent donc :

Connexion chiffrée

Tous les appels passent par HTTPS.

Clés API protégées

Les clés sont stockées chiffrées et peuvent être révoquées individuellement à tout moment.

Protection contre les abus

La connexion et l’API sont limitées contre les tentatives répétées et la surcharge.

Comptes séparés

Chaque client ne voit que ses propres requêtes et clés.

Les termes en bref

N° de TVA: Numéro d’identification à la taxe sur la valeur ajoutée. Il commence par un préfixe pays, par exemple FR pour la France, suivi du numéro.
VIES: Le système d’échange d’informations sur la TVA de la Commission européenne. Il transmet votre requête à l’administration fiscale nationale.
Numéro de consultation: L’identifiant sous lequel VIES documente une requête comportant un demandeur.
Demandeur: C’est vous : votre propre numéro de TVA, envoyé avec la requête.
Code de requête: Le code court VV-… de VerifyVAT. Il est unique par requête et recherchable dans le tableau de bord.

Questions fréquentes

Pourquoi ai-je besoin de mon propre numéro de TVA ?+

VIES n’émet un numéro de consultation que si le demandeur est indiqué. Sans numéro de TVA enregistré, l’API n’est donc pas activée.

Qu’est-ce que le numéro de consultation ?+

C’est l’identifiant par lequel VIES documente une requête comportant un demandeur. Vous le conservez comme preuve avec vos pièces.

D’où viennent les données ?+

Tout provient de VIES, le service de la Commission européenne. VerifyVAT n’est pas une offre de la Commission européenne.

Quels pays sont couverts ?+

Les 27 États membres de l’UE ainsi que l’Irlande du Nord (XI). Les numéros de Suisse, du Royaume-Uni ou d’autres pays tiers sont inconnus de VIES.

Que signifie « invalide » ?+

VIES ne considère pas le numéro comme valide au moment de la requête. Cela peut être une faute de frappe, un numéro pas encore activé ou supprimé. En cas de doute, interrogez votre partenaire.

Que se passe-t-il si VIES est injoignable ?+

L’API répond 502 et vous donne le code de requête. Rien n’est signalé comme valide. Vous pouvez renvoyer la requête plus tard.

Puis-je l’utiliser sans programmer ?+

Oui. Le tableau de bord propose un vérificateur manuel, avec votre entreprise déjà renseignée comme demandeur.

Combien cela coûte-t-il ?+

Actuellement rien. Votre quota est affiché dans votre tableau de bord.

Prêt pour votre premier contrôle ?

Créez un compte, générez une clé, c’est parti. Quelques minutes suffisent.