Verifica Partita IVA

Questa API permette di verificare la validità di una Partita IVA interrogando il sistema ufficiale di verifica dell'Unione Europea.

🔗 Endpoint

GET /api/v1/verifica/partita-iva/:partitaIva

🔑 Autenticazione

Questa API richiede autenticazione tramite una API Key. La chiave deve essere inviata nell'intestazione della richiesta.

Esempio di invio dell'API Key:

Authorization: Bearer <API_KEY>

📥 Parametri della richiesta

Parametri nel percorso (param)

Nome	Tipo	Obbligatorio	Descrizione
partitaIva	string	✅ Sì	La partita IVA da verificare

📌 Esempio di richiesta con cURL

curl -X GET "https://api.codicefiscale.dev/api/v1/verifica/partita-iva/IT12345678901"
     -H "Authorization: Bearer <API_KEY>"

📤 Risposta

✅ Esempio di risposta (200 OK)

{
  "isValid": true,
  "name": "Azienda Esempio Srl",
  "address": "Via Esempio, 123, Milano"
}

❌ Esempio di risposta (500 Error)

{
  "error": "Failed to verify Partita IVA"
}

❌ Possibili errori

Codice	Messaggio	Descrizione
500	"Failed to verify Partita IVA"	Errore nel verificare la partita IVA
401	"Unauthorized"	API Key mancante o non valida
400	"Bad Request"	Parametro partitaIva mancante o malformato

💡 Esempi di utilizzo

🛠 Esempio con JavaScript (fetch)

fetch(
  "https://api.codicefiscale.dev/api/v1/verifica/partita-iva/IT12345678901",
  {
    headers: {
      Authorization: "Bearer <API_KEY>",
    },
  }
)
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error("Errore:", error));

🛠 Esempio con Python (requests)

import requests

url = "https://api.codicefiscale.dev/api/v1/verifica/partita-iva/IT12345678901"
headers = {
    "Authorization": "Bearer <API_KEY>"
}

response = requests.get(url, headers=headers)
print(response.json())