Identité et vérification

API de validation de numéro de TVA

Vérifiez les numéros de TVA de vos clients au moment du paiement ou de l'inscription. Les numéros de l'UE et d'Irlande du Nord sont vérifiés en direct auprès du registre de la TVA de l'UE et les numéros norvégiens auprès du registre norvégien des entreprises, avec le nom et l'adresse enregistrés lorsque le pays les communique.

Voir la documentation Essayer l’outil gratuit Explorer toutes les API

Points de terminaison Actif

GET /v1/vat/validate

Exemple de requête

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/vat/validate?vat=NO923609016MVA"

Exemple de réponse 200 OK

{
  "vat_number": "NO923609016MVA",
  "country_code": "NO",
  "status": "valid",
  "valid": true,
  "reason": "active_vat_registration",
  "format_valid": true,
  "checksum": "valid",
  "registered_name": "EQUINOR ASA",
  "registered_address": "Forusbeen 50, 4035 STAVANGER, Norge",
  "name_disclosed": true,
  "details": { "vat_registered": true, "vat_registe
...

Exemple de requête GET /v1/vat/validate

Fonctionnalités clés 4

Questions fréquentes 4

Codes de statut HTTP 200 / 400 / 401 / 402 / 429

Catégorie Identité et vérification

Points de terminaison 1

Fonctionnalités clés 4

Questions fréquentes 4

Utilisé par des équipes de ces entreprises

Signaux de confiance avant intégration

Une documentation transparente, des requêtes authentifiées et des détails de fiabilité visibles facilitent l’évaluation de DomScan avant mise en production.

En direct État du service

Vérifiez l’état du service en direct et les réponses d’échec documentées avant de procéder à l’intégration.

OpenAPI Artefacts API

OpenAPI, Swagger, Postman, CLI, SDK et liens MCP sont accessibles en un clic.

Clés API Accès protégé

Les endpoints authentifiés utilisent des clés API avec des coûts en crédits clairs avant l’appel.

10,000 Quota gratuit

Commencez avec 10 000 crédits mensuels et passez à l’offre supérieure seulement quand l’usage augmente.

Ce que cette API vous aide à livrer

Utilisez cette page comme brief de production : endpoints, exemples, structure de réponse et éléments de workflow pour intégrer DomScan à votre produit.

Workflows produit

Intégrez vérifications de domaines, intelligence DNS, signaux de risque ou enrichissement dans l’onboarding, la recherche et les outils internes.

Automatisation analyste

Remplacez les recherches manuelles répétées par des tâches planifiées, des alertes et des étapes d’enquête reproductibles.

Données JSON propres

Utilisez des champs prévisibles, des codes d’état documentés et des coûts en crédits au lieu de scraper des pages fournisseur.

IA et opérations

Alimentez agents, tableaux de bord, playbooks SOAR et CRMs via OpenAPI, SDK, Postman ou MCP.

Flux d’intégration

Un parcours simple de la première requête à un usage répétable en production.

Authentifier une fois

Envoyez votre clé API avec l’en-tête documenté et gardez des requêtes cohérentes entre services.

Interroger avec les exemples

Commencez par les exemples curl et HTTP, puis mappez les paramètres dans le code de votre application.

Exploiter et surveiller

Utilisez codes d’état, coûts en crédits et champs de réponse pour construire retries, logs et alertes.

Kit développeur

Passez de cette page aux docs lisibles par machine, collections de requêtes, SDKs ou outils d’agents.

Schéma OpenAPI

Générez des clients ou inspectez chaque forme de requête et de réponse.

Collection Postman

Importez des requêtes prêtes pour les tests manuels et le transfert à l’équipe.

SDKs et CLI

Utilisez des packages maintenus et des workflows en ligne de commande au lieu d’écrire du boilerplate.

Intégration MCP

Exposez l’intelligence de domaines aux agents IA et aux assistants internes.

Carte des paramètres et réponses

Parcourez les entrées, champs de sortie et codes d’état avant de connecter l’endpoint à votre client.

Paramètres de requête

Paramètre

vatcountryrequester

Champs de réponse

Exemple de réponse

vat_numbercountry_codestatusvalidreasonformat_validchecksumregistered_nameregistered_addressname_discloseddetailsdetails.vat_registered

Couverture des statuts

Codes de statut HTTP

200400401402429

Points de terminaison

GET /v1/vat/validate

Crédits: 1Authentification: Authentification requise

Signaux de confiance avant intégration

Une documentation transparente, des requêtes authentifiées et des détails de fiabilité visibles facilitent l’évaluation de DomScan avant mise en production.

En direct État du service

Vérifiez l’état du service en direct et les réponses d’échec documentées avant de procéder à l’intégration.

OpenAPI Artefacts API

OpenAPI, Swagger, Postman, CLI, SDK et liens MCP sont accessibles en un clic.

Clés API Accès protégé

Les endpoints authentifiés utilisent des clés API avec des coûts en crédits clairs avant l’appel.

10,000 Quota gratuit

Commencez avec 10 000 crédits mensuels et passez à l’offre supérieure seulement quand l’usage augmente.

Fonctionnalités clés

Vérifications en direct auprès du registre

La validité provient du registre officiel au moment de votre demande, et non d'une liste en cache ni d'une simple vérification de format.

Preuve de votre vérification

Envoyez votre propre numéro de TVA de l'UE comme demandeur pour recevoir un numéro de consultation que vous pouvez conserver comme preuve pour la facturation en autoliquidation.

Format et clé de contrôle d'abord

Les numéros mal formés sont rejetés sans appel au registre, et la clé de contrôle est indiquée pour chaque pays pris en charge.

Inconnu, jamais invalide

Lorsqu'un registre national est hors ligne ou saturé, le résultat est inconnu avec la raison, et la requête n'est pas facturée.

Exemple de requête

GET /v1/vat/validate?vat=NO923609016MVA bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/vat/validate?vat=NO923609016MVA"

Exemple de réponse

200 OK json

{
  "vat_number": "NO923609016MVA",
  "country_code": "NO",
  "status": "valid",
  "valid": true,
  "reason": "active_vat_registration",
  "format_valid": true,
  "checksum": "valid",
  "registered_name": "EQUINOR ASA",
  "registered_address": "Forusbeen 50, 4035 STAVANGER, Norge",
  "name_disclosed": true,
  "details": { "vat_registered": true, "vat_registered_since": "1989-07-01", "bankrupt": false }
}

Questions fréquentes

Quels pays sont couverts ?

Les 27 pays de l'UE et l'Irlande du Nord sont vérifiés en direct, tout comme la Norvège. Les numéros britanniques, suisses et australiens sont vérifiés pour le format et la clé de contrôle, car ces registres ne proposent pas de vérification publique gratuite.

Pourquoi le nom de l'entreprise est-il absent ?

Certains pays, comme l'Allemagne et l'Espagne, ne communiquent pas les noms et adresses via le registre de l'UE. Le résultat définit alors name_disclosed sur false.

Que signifie inconnu ?

Le registre n'a pas pu donner de réponse : il était indisponible, saturé ou trop lent. Réessayez plus tard. Les résultats inconnus sont remboursés.

Combien de crédits cela coûte-t-il ?

Un crédit par vérification. Les vérifications qui se terminent par inconnu ne sont pas facturées.

Outils et ressources associés

Codes de statut HTTP

Voici les codes d'état HTTP à gérer, afin de distinguer les réponses réussies, les problèmes d'authentification, les crédits, les limites de débit, les données introuvables et les erreurs en amont.

OK 200

Requête réussie

Requête incorrecte 400

Paramètres invalides

Non autorisé 401

Clé API ou session manquante ou invalide.

Paiement requis 402

Crédits insuffisants pour exécuter cette requête.

Trop de requêtes 429

Limite de débit dépassée

Valider un numéro de TVA

Commencer gratuitement Voir la documentation Essayer l’outil gratuit