Validazione partita IVA UE API
Verifica qualsiasi partita IVA europea su VIES, il registro ufficiale della Commissione europea. Conferma in tempo reale, più ragione sociale e indirizzo registrati quando lo Stato membro li divulga.
Non hai una API key?
Accedi al tuo account per creare e gestire le tue API key.
Guida all'integrazione
Copia uno snippet, sostituisci la tua API key, esegui. Funziona con qualsiasi client HTTP — esempi qui sotto in cURL, JavaScript e Python.
/api/validate-vathttps://www.apipick.comValidate an EU VAT number against the official VIES registry
vat_numberstringobbligatorioFull VAT number with its two-letter member-state prefix. Spaces, dots, and hyphens are stripped. IE6388047V
countrystringfacoltativoMember-state code, if the number is supplied without its prefix. Greece is EL, not GR. IE
curl -X GET "https://www.apipick.com/api/validate-vat" \
-H "x-api-key: YOUR_API_KEY"{
"vat_number": "IE6388047V",
"country_code": "IE",
"number": "6388047V",
"valid": true,
"name": "GOOGLE IRELAND LIMITED",
"address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
"name_disclosed": true,
"request_date": "2026-09-01T11:52:22.440Z",
"consultation_number": null,
"source": "European Commission VIES",
"credits_used": 3,
"remaining_credits": 97
}Costruita per casi d'uso reali
Fatturazione in reverse charge
Conferma la registrazione IVA dell'acquirente prima di emettere una fattura B2B transfrontaliera non imponibile, e conserva traccia della verifica.
Onboarding B2B
Verifica in fase di registrazione e precompila ragione sociale e indirizzo dal registro, invece di chiederli al cliente.
Prevenzione delle frodi
Intercetta partite IVA inventate o cessate prima che entrino nel tuo sistema di fatturazione o in una dichiarazione fiscale.
Flussi con agenti
Dai a un agente finanziario uno strumento con un solo parametro, richiamabile mentre elabora una fattura, con una risposta booleana inequivocabile.
Campi della risposta
| Campo | Tipo | Descrizione |
|---|---|---|
| valid | boolean | Se la partita IVA è attualmente registrata per gli scambi transfrontalieri |
| country_code | string | Codice dello Stato membro come dichiarato (EL per la Grecia, XI per l'Irlanda del Nord) |
| number | string | La partita IVA senza il prefisso del Paese |
| name | string | null | Ragione sociale registrata, quando lo Stato membro la divulga |
| address | string | null | Indirizzo registrato, quando lo Stato membro lo divulga |
| name_disclosed | boolean | False quando lo Stato membro omette i dati identificativi per scelta normativa (DE, ES) |
| request_date | string | null | Marca temporale registrata da VIES per la verifica |
| consultation_number | string | null | Identificativo della consultazione VIES, utilizzabile come prova della verifica |
| credits_used | integer | Crediti scalati per questa richiesta |
| remaining_credits | integer | Crediti rimanenti nel tuo account |
Limiti di frequenza
Il throttling è per API key, con finestra mobile di 60 secondi. Al raggiungimento del limite ricevi un 429 pulito con header Retry-After.
20req/min
Per API key e per endpoint. Finestra mobile di 60 secondi.
3concurrent
Numero massimo di richieste simultanee in corso per API key.
X-RateLimit-LimitNumero massimo di richieste consentite al minutoX-RateLimit-RemainingRichieste rimanenti nella finestra correnteX-RateLimit-ResetSecondi al reset della finestra correnteRetry-AfterSecondi da attendere prima di riprovare (solo in caso di 429)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 20
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 20 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}Fonte dei dati e licenza
Le verifiche passano da VIES, il sistema di scambio di informazioni sull'IVA della Commissione europea, che inoltra ogni interrogazione in tempo reale alla banca dati fiscale dello Stato membro competente. Non conserviamo alcuna copia del registro: la risposta è dell'amministrazione fiscale e noi la restituiamo in JSON pulito, esplicitando i casi di indisponibilità e di mancata divulgazione.
Domande frequenti
D: È la verifica ufficiale dell'UE?
R: Sì. La richiesta va a VIES, il sistema di scambio di informazioni sull'IVA della Commissione europea, che interroga in tempo reale la banca dati fiscale dello Stato membro competente. Non esiste una banca dati intermedia, quindi la risposta coincide con quella del modulo web della Commissione.
D: Perché per le partite IVA tedesche la ragione sociale è vuota?
R: Germania e Spagna non divulgano ragione sociale e indirizzo tramite VIES per scelta normativa. La registrazione della partita IVA viene comunque confermata o smentita in modo chiaro: solo i dati identificativi restano omessi. La risposta imposta name_disclosed: false così puoi distinguere l'omissione normativa da un campo davvero vuoto.
D: Cosa succede se il sistema di uno Stato membro è fuori servizio?
R: VIES instrada verso la banca dati di ciascuno Stato membro, e queste vanno offline per manutenzione. In quel caso ricevi un HTTP 503 con un messaggio chiaro e nessun credito viene addebitato. Riprova dopo qualche minuto: il disservizio è dal lato dell'amministrazione fiscale, non dal nostro.
D: Quali codici Paese sono supportati?
R: Tutti i 27 Stati membri più XI per l'Irlanda del Nord, in base al quadro di Windsor. Nota che la Grecia dichiara l'IVA con il codice EL e non con il codice ISO GR. La Gran Bretagna (GB) è uscita da VIES dopo la Brexit e non è coperta.
D: Posso ottenere un numero di consultazione per la mia pista di controllo?
R: Il campo consultation_number riporta l'identificativo della richiesta VIES quando viene rilasciato. È proprio quell'identificativo che un'amministrazione fiscale accetta come prova che hai verificato la posizione IVA di una controparte in una data precisa, aspetto rilevante nel reverse charge.