> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Endpoint de validation TVA

> L'endpoint `validate` traite les soumissions de numéros de TVA pour vérifier leur authenticité et récupérer des informations commerciales complètes, notamment les détails de l'entreprise, l'adresse et les données d'enregistrement du pays.

## 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é :

<ResponseExample>
  ```json theme={"system"}
  {
      "company": {
          "address": "8 RUE DE LONDRES\n75009 PARIS",
          "name": "EURL GOOGLE FRANCE"
      },
      "country": {
          "code": "FR",
          "name": "France"
      },
      "valid": true,
      "vat_number": "FR64443061841"
  }
  ```
</ResponseExample>

### Paramètres de requête

<ParamField query="api_key" type="String" required>
  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.
</ParamField>

<ParamField query="vat_number" type="String" required>
  Le numéro de TVA à valider.
</ParamField>

### Paramètres de réponse

La réponse de l'API est renvoyée dans un [format JSON](https://www.json.org/json-en.html) universel et léger.

<ResponseField name="vat_number" type="String">
  Le numéro de TVA à valider.
</ResponseField>

<ResponseField name="valid" type="Boolean">
  Est vrai si le numéro de TVA soumis est valide.
</ResponseField>

<ResponseField name="company" type="Object">
  Objet contenant les informations de l'entreprise.
</ResponseField>

<ResponseField name="company.name" type="String">
  Le nom de l'entreprise associée au numéro de TVA.
</ResponseField>

<ResponseField name="company.address" type="String">
  L'adresse de l'entreprise associée au numéro de TVA.
</ResponseField>

<ResponseField name="country" type="Object">
  Objet contenant les informations sur le pays.
</ResponseField>

<ResponseField name="country.code" type="String">
  Le code ISO 3166-1 alpha-2 à deux lettres du pays associé au numéro de TVA.
</ResponseField>

<ResponseField name="country.name" type="String">
  Le nom du pays associé au numéro de TVA.
</ResponseField>