API per la verifica della partita IVA

Verificare, e poterlo dimostrare.

VerifyVAT interroga in tempo reale VIES per le partite IVA dei tuoi partner commerciali e conserva a ogni controllo il numero di consultazione ufficiale. Così potrai dimostrare in seguito che hai verificato, e quando.

Registrati gratis Accedi

I nuovi account partono con 1.000 richieste al mese.

Registro di verificaEsempio

Codice richiesta: VV-3F9A1C2E
Partita IVA verificata: DE123456789
Risultato: valida
Azienda (secondo VIES): Muster GmbH
Richiedente: LU32633157
Data e ora: 2026-10-11 01:14:09

Numero di consultazione (VIES)

WAPIAAAAZ4Kq8vDn

Conservato nel tuo account, consultabile nella cronologia e in CSV.

provato

27 + XI: Stati membri dell’UE e Irlanda del Nord, coperti tramite VIES
VV-…: Un codice richiesta univoco per ogni singolo controllo
Prova: Il numero di consultazione ufficiale viene conservato a ogni richiesta
CSV: Cronologia completa esportabile per contabilità e verifiche

01Perché verificare?

Una partita IVA valida decide spesso il trattamento fiscale

Se vendi a imprese di altri Paesi UE devi sapere con chi hai a che fare. La partita IVA del partner è l’identificativo chiave e la sua validità può cambiare nel tempo.

Cessioni non imponibili

Le cessioni intracomunitarie a imprese di un altro Stato UE sono di regola non imponibili solo se il cliente usa una partita IVA valida. Se non puoi dimostrarlo, rischi una rettifica.

Inversione contabile sui servizi

Per molti servizi B2B l’imposta è dovuta dal destinatario. La verifica mostra che il tuo cliente è registrato come impresa prima di fatturare senza IVA.

Prova in caso di verifica fiscale

L’amministrazione può chiedere in seguito se e quando hai verificato. Con codice richiesta, data e ora e numero di consultazione hai una risposta che non devi ricostruire.

Questa non è consulenza fiscale. Quali prove servono nel tuo caso va chiarito con il tuo consulente fiscale.

02Semplice o qualificata

La differenza tra «valida» e «provata»

VIES conosce due tipi di richiesta. Per la documentazione conta la seconda.

Richiesta semplice

Invii solo il numero del partner. VIES risponde se è valido. Non esiste un identificativo della richiesta, quindi hai solo la tua memoria o uno screenshot.

GET /check?vat_number=DE123456789
→ { "valid": true }

Questo è ciò che VerifyVAT fa a ogni richiesta

Richiesta con richiedente

Indichi anche la tua partita IVA. VIES rilascia allora un numero di consultazione per quella precisa richiesta. VerifyVAT invia automaticamente la tua partita IVA e conserva il numero.

GET /check?vat_number=DE123456789
→ { "valid": true,
    "consultation_number": "WAPIAAAAZ4Kq8vDn" }

Come funziona

Dalla registrazione al primo controllo bastano pochi minuti.

1
Crea un account
Ti registri con i dati della tua azienda, inclusa la tua partita IVA. Viene inviata a VIES come richiedente a ogni controllo; solo così VIES rilascia una prova.
2
Crea una chiave
Nella dashboard generi una chiave API per ogni applicazione, ad esempio negozio o ERP. Puoi revocare una chiave in qualsiasi momento.
3
Invia richieste
Invii alla API la partita IVA del tuo cliente. Risposta, numero di consultazione e il nostro codice richiesta vengono salvati subito.

04Per sviluppatori

Una richiesta, una risposta

La API è una semplice chiamata GET con la tua chiave in un’intestazione. Ricevi JSON con il risultato, i dati dell’azienda secondo VIES e la prova. Scrivi la partita IVA del cliente con il prefisso paese, ad esempio DE123456789.

Ogni richiesta riceve un codice univoco (VV-…), anche se fallisce.
Quota mensile e limite al minuto sono definiti per account e visibili nella dashboard.
Se VIES non è raggiungibile ricevi un 502 e il codice richiesta. Nulla viene segnalato per errore come valido.

Richiesta

curl "https://verifyvat.eu/api/v2/check?vat_number=DE123456789" \
  -H "apikey: vat_xxxxxxxx_xxxxxxxxxxxxxxxx"

Risposta

{
  "request_code": "VV-3F9A1C2E",
  "valid": true,
  "query": "DE123456789",
  "company_name": "Muster GmbH",
  "company_address": "Musterstraße 1, 10115 Berlin",
  "consultation_number": "WAPIAAAAZ4Kq8vDn",
  "vies_request_date": "2026-10-11T01:14:09.000Z",
  "proof_available": true
}

I campi della risposta

request_code: Il tuo codice richiesta (VV-…). Ricercabile nella dashboard.
valid: true se VIES considera il numero valido, altrimenti false.
company_name / company_address: Nome e indirizzo secondo VIES, se lo Stato membro li fornisce.
consultation_number: Il numero di consultazione di VIES. È la tua prova.
vies_request_date: Momento della richiesta secondo VIES.
proof_available: true se VIES ha rilasciato un numero di consultazione.

Codici di stato

Un numero non valido non è un errore: ottieni 200 e valid: false.

200: Richiesta elaborata, risultato nel campo valid.
400: vat_number manca o ha un formato non valido.
401: L’intestazione apikey manca, oppure la chiave non è valida o è stata revocata.
402: La quota mensile è esaurita.
403: Nell’account non è ancora salvata una partita IVA propria.
429: Superato il limite al minuto. Attendi un attimo e riprova.
502: VIES al momento non è raggiungibile. La richiesta è salvata con il suo codice.

Cosa vedi nel tuo account

La dashboard è pensata per ritrovare ogni controllo in pochi secondi.

Cronologia

Tutte le richieste con codice, risultato, azienda, numero di consultazione e data e ora. Ricerca per codice, partita IVA e numero di consultazione.

Esportazione CSV

L’intera cronologia in un file per la contabilità o le verifiche.

Controllo manuale

Verifica un singolo numero a mano. La tua azienda è già inserita come richiedente.

Più chiavi

Una chiave per sistema, revocabile singolarmente, per sapere sempre da dove arriva una richiesta.

Utilizzo

Quota mensile usata e residua, limite al minuto e percentuale di successo a colpo d’occhio.

Aiuto

Documentazione con esempi e un modulo di assistenza raggiungibile da ogni pagina.

Come lo usano i team

Negozio online e checkout

Verifica la partita IVA nel momento in cui il cliente la inserisce al checkout ed emetti la fattura di conseguenza.

ERP e contabilità

Controlla i nuovi clienti alla creazione e ricontrolla periodicamente l’anagrafica. Archivia il numero di consultazione insieme al documento.

SaaS e onboarding

Verifica i clienti aziendali alla registrazione senza che nessuno debba cercare a mano su un sito istituzionale.

06Sicurezza

Accessi e dati sono protetti

Ci affidi accessi API e dati aziendali. Per questo valgono queste regole di base:

Connessione cifrata

Tutte le chiamate passano su HTTPS.

Chiavi API protette

Le chiavi sono salvate cifrate e si possono revocare singolarmente in qualsiasi momento.

Protezione dagli abusi

Accesso e API sono limitati contro tentativi ripetuti e sovraccarico.

Account separati

Ogni cliente vede solo le proprie richieste e chiavi.

I termini in breve

Partita IVA: Numero di identificazione ai fini IVA. Inizia con un prefisso paese, ad esempio IT per l’Italia, seguito dal numero.
VIES: Il sistema di scambio di informazioni sull’IVA della Commissione europea. Inoltra la tua richiesta all’amministrazione fiscale nazionale.
Numero di consultazione: L’identificativo con cui VIES documenta una richiesta che include un richiedente.
Richiedente: Sei tu: la tua partita IVA, inviata insieme alla richiesta.
Codice richiesta: Il codice breve VV-… di VerifyVAT. È univoco per richiesta e ricercabile nella dashboard.

Domande frequenti

Perché mi serve la mia partita IVA?+

VIES rilascia il numero di consultazione solo se è indicato il richiedente. Senza una partita IVA salvata, la API non è quindi attivata.

Che cos’è il numero di consultazione?+

È l’identificativo con cui VIES documenta una richiesta che include un richiedente. Lo conservi come prova insieme ai tuoi documenti.

Da dove arrivano i dati?+

Tutto proviene da VIES, il servizio della Commissione europea. VerifyVAT non è un’offerta della Commissione europea.

Quali Paesi sono coperti?+

Tutti i 27 Stati membri dell’UE più l’Irlanda del Nord (XI). I numeri di Svizzera, Regno Unito o altri Paesi terzi non sono noti a VIES.

Che cosa significa «non valida»?+

VIES non considera il numero valido al momento della richiesta. Può essere un errore di battitura, un numero non ancora attivato o cancellato. In caso di dubbio, chiedi al tuo partner commerciale.

Che cosa succede se VIES non è raggiungibile?+

La API risponde con 502 e ti dà il codice richiesta. Nulla viene segnalato come valido. Puoi inviare di nuovo la richiesta più tardi.

Posso usarlo senza programmare?+

Sì. La dashboard ha un verificatore manuale, con la tua azienda già inserita come richiedente.

Quanto costa?+

Al momento niente. La tua quota è visibile nella dashboard.

Pronto per il primo controllo?

Crea un account, genera una chiave e parti. Bastano pochi minuti.