> ## 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 di validazione IVA

> L'endpoint `validate` elabora le partite IVA inviate per verificarne l'autenticità e recuperare informazioni aziendali complete, inclusi dettagli dell'azienda, indirizzo e dati di registrazione nel paese.

## Per iniziare

### URL di base

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

### Endpoint di validazione

L'endpoint `validate` richiede la tua chiave API univoca e la partita IVA da verificare:

```
https://vat.cleariflow.com/v1/validate/
? api_key = YOUR_UNIQUE_API_KEY
& vat_number = FR64443061841
```

Questa richiesta riuscita restituisce informazioni aziendali complete associate alla partita IVA validata:

<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>

### Parametri della richiesta

<ParamField query="api_key" type="String" required>
  La tua chiave API univoca. Nota che ogni utente ha chiavi API univoche per ciascuna delle API Cleariflow, quindi la chiave dell'API di validazione IVA e aliquote non funzionerà per l'API di geolocalizzazione IP, ad esempio.
</ParamField>

<ParamField query="vat_number" type="String" required>
  La partita IVA da validare.
</ParamField>

### Parametri della risposta

La risposta API viene restituita in un [formato JSON](https://www.json.org/json-en.html) universale e leggero.

<ResponseField name="vat_number" type="String">
  La partita IVA da validare.
</ResponseField>

<ResponseField name="valid" type="Boolean">
  È `true` se la partita IVA inviata è valida.
</ResponseField>

<ResponseField name="company" type="Object">
  Oggetto contenente le informazioni sull'azienda.
</ResponseField>

<ResponseField name="company.name" type="String">
  Il nome dell'azienda associata alla partita IVA.
</ResponseField>

<ResponseField name="company.address" type="String">
  L'indirizzo dell'azienda associata alla partita IVA.
</ResponseField>

<ResponseField name="country" type="Object">
  Oggetto contenente le informazioni sul paese.
</ResponseField>

<ResponseField name="country.code" type="String">
  Il codice ISO 3166-1 alpha-2 a due lettere del paese associato alla partita IVA.
</ResponseField>

<ResponseField name="country.name" type="String">
  Il nome del paese associato alla partita IVA.
</ResponseField>