API aliquote IVA v1
Un dataset JSON gratuito con le aliquote IVA/GST di 67 paesi: codici ISO paese, codici ISO valuta, URL dei calcolatori per paese, fonti ufficiali e date di ultima verifica.
Endpoint
Usa l’endpoint versionato per le nuove integrazioni. Formato della risposta: application/json. Il CORS è abilitato per le chiamate dal browser.
L’endpoint legacy resta per retrocompatibilità e al momento restituisce lo stesso dataset.
Fetch rapido
const res = await fetch('https://vatestimator.com/api/v1/rates.json');
const data = await res.json();
const italy = data.rates.find(row => row.code === 'IT');
console.log(italy.standard_rate); // 22
Esempio con curl
curl -s https://vatestimator.com/api/v1/rates.json | jq '.rates[] | select(.code=="DE")'
Campi della risposta
| Campo | Tipo | Descrizione |
|---|---|---|
meta.schema_version | string | Versione dello schema del dataset. L’endpoint v1 attuale usa 1.2. |
meta.last_updated | string | Data di aggiornamento del dataset in formato ISO. |
meta.last_verified | string | Data di verifica del dataset in formato ISO. |
meta.total_countries | number | Numero di righe paese incluse. |
rates[].code | string | Codice paese ISO 3166-1 alpha-2, es. IT. |
rates[].slug | string | Slug stabile del paese usato da VATEstimator. |
rates[].country | string | Nome del paese in inglese. |
rates[].region | array | Tag di area come eu, europe, americas, apac. |
rates[].currency | string | Solo simbolo di visualizzazione. Non usarlo come identificatore univoco della valuta. |
rates[].currency_code | string | Codice valuta ISO 4217, es. EUR, USD, GBP. |
rates[].standard_rate | number|null | Aliquota ordinaria, oppure null quando non esiste un'unica aliquota nazionale confrontabile. |
rates[].rates[] | array | Aliquote disponibili per il paese. |
rates[].rates[].rate_percent | number | Aliquota in percentuale. Campo da preferire nelle nuove integrazioni. |
rates[].rates[].rate | number | Alias retrocompatibile di rate_percent. |
rates[].rates[].label | string | Etichetta leggibile come Standard o Reduced. |
rates[].page_url | string | Pagina del calcolatore VATEstimator per quel paese. |
rates[].official_source_url | string | URL della fonte ufficiale (autorità fiscale o governo) mappata per il paese. |
rates[].source_name | string | Nome della fonte ufficiale. |
rates[].last_verified | string | Data dell’ultimo controllo di questa riga paese. |
rates[].source_note | string | Breve nota di verifica/avvertenza. |
Oggetto di esempio
{
"code": "IT",
"slug": "italy",
"country": "Italy",
"region": ["eu", "europe"],
"currency": "€",
"currency_code": "EUR",
"standard_rate": 22,
"rates": [
{ "rate_percent": 22, "rate": 22, "label": "Standard" },
{ "rate_percent": 10, "rate": 10, "label": "Reduced" },
{ "rate_percent": 5, "rate": 5, "label": "Reduced" },
{ "rate_percent": 4, "rate": 4, "label": "Super-reduced" }
],
"page_url": "https://vatestimator.com/it/vat-calculator-italy/",
"source_name": "Agenzia delle Entrate",
"official_source_url": "https://www.agenziaentrate.gov.it",
"last_verified": "2026-08-19"
}
Simboli di valuta e codici ISO
Usa currency_code per logica, archiviazione, URL e conversioni. Il campo currency è solo un simbolo di visualizzazione: valori come $, kr o ¥ sono condivisi da più valute.
Attribuzione e verifica
Uso libero con attribuzione. Un link a VATEstimator è gradito.
Le aliquote e le regole IVA/GST possono cambiare. Questo dataset è fornito solo a titolo di riferimento. Verifica sempre official_source_url prima di dichiarazioni, fatturazione o decisioni fiscali.