Passer au contenu principal
GET
/
v1
/
validate
Endpoint de validation TVA
curl --request GET \
  --url https://vat.cleariflow.com/v1/validate/
{
    "company": {
        "address": "8 RUE DE LONDRES\n75009 PARIS",
        "name": "EURL GOOGLE FRANCE"
    },
    "country": {
        "code": "FR",
        "name": "France"
    },
    "valid": true,
    "vat_number": "FR64443061841"
}

​
Premiers pas

​
URL de base

https://vat.cleariflow.com/v1/validate/

​
Endpoint de validation

L’endpoint validate requiert votre clé API unique et le numéro de TVA que vous souhaitez vérifier : 
https://vat.cleariflow.com/v1/validate/
? api_key = YOUR_UNIQUE_API_KEY
& vat_number = FR64443061841
Cette requête réussie renvoie des informations complètes sur l’entreprise associée au numéro de TVA validé : 
{
    "company": {
        "address": "8 RUE DE LONDRES\n75009 PARIS",
        "name": "EURL GOOGLE FRANCE"
    },
    "country": {
        "code": "FR",
        "name": "France"
    },
    "valid": true,
    "vat_number": "FR64443061841"
}

​
Paramètres de requête

​
api_key
String
requis
Votre clé API unique. Notez que chaque utilisateur possède des clés API uniques pour chaque API Cleariflow ; votre clé de l’API de validation TVA et taux ne fonctionnera pas pour votre API de géolocalisation IP, par exemple.
​
vat_number
String
requis
Le numéro de TVA à valider.

​
Paramètres de réponse

La réponse de l’API est renvoyée dans un format JSON universel et léger.
​
vat_number
String
Le numéro de TVA à valider.
​
valid
Boolean
Est vrai si le numéro de TVA soumis est valide.
​
company
Object
Objet contenant les informations de l’entreprise.
​
company.name
String
Le nom de l’entreprise associée au numéro de TVA.
​
company.address
String
L’adresse de l’entreprise associée au numéro de TVA.
​
country
Object
Objet contenant les informations sur le pays.
​
country.code
String
Le code ISO 3166-1 alpha-2 à deux lettres du pays associé au numéro de TVA.
​
country.name
String
Le nom du pays associé au numéro de TVA.