Vai al contenuto principale
GET
/
v1
/
validate
Endpoint di validazione IVA
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"
}

​
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: 
{
    "company": {
        "address": "8 RUE DE LONDRES\n75009 PARIS",
        "name": "EURL GOOGLE FRANCE"
    },
    "country": {
        "code": "FR",
        "name": "France"
    },
    "valid": true,
    "vat_number": "FR64443061841"
}

​
Parametri della richiesta

​
api_key
String
obbligatorio
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.
​
vat_number
String
obbligatorio
La partita IVA da validare.

​
Parametri della risposta

La risposta API viene restituita in un formato JSON universale e leggero.
​
vat_number
String
La partita IVA da validare.
​
valid
Boolean
È true se la partita IVA inviata è valida.
​
company
Object
Oggetto contenente le informazioni sull’azienda.
​
company.name
String
Il nome dell’azienda associata alla partita IVA.
​
company.address
String
L’indirizzo dell’azienda associata alla partita IVA.
​
country
Object
Oggetto contenente le informazioni sul paese.
​
country.code
String
Il codice ISO 3166-1 alpha-2 a due lettere del paese associato alla partita IVA.
​
country.name
String
Il nome del paese associato alla partita IVA.