L'API è stata sostituita dai nuovi endpoint disponibili in Company
Per accedere a tutti i dati anagrafici, le informazioni sull'attività, i soci ed alcuni dati economici di un’impresa italiana scopri i nuovi servizi di Company.
Deprecated starting from 2025-12-31
Il parametro dipende dall'endpoint per cui si vuole effettuare la richiesta.
Per il GET /base, /advance, /closed, /gruppoiva, /pec, /soci il parametro da utilizzare è uno dei seguenti:
- partita iva
- codice fiscale
- id (solo per base e advance)
Per l'endpoint GET Advance (Ricerca Avanzata) è possibile passare uno o più dei seguenti parametri:
- nome o parte (in questo caso il nome deve essere sempre intero) della denominazione aziendale
- provincia
- codice ATECO
- CCIAA
- REA
- fatturato minimo e/o massimo
- dipendenti minimo e/o massimo
Per l'endpoint GET /Autocomplete il parametro può essere una stringa (anche con carattere jolly "*") e facoltativamente latitudine, longitudine e raggio.
Per l'endpoint GEt /forma_giuridica non è necessario alcun parametro, mentre per Get /forma_giuridica/ è il codice natura giuridica.
Per l'endpoint GET /updates i parametri, tutti facoltativi, sono latitudine, longitudine, raggio.
Per l'endpoint GET /updates/{timestamp} ai precedenti endpoint va aggiunto quello obbligatorio: timestamp (cioè la data a partire dalla quale iniziare la ricerca).
L’API Imprese offre informazioni su qualsiasi tipologia di azienda italiana. Il dataset disponibile nella risposta può dipendere dal fatto che l’attività sia iscritta o meno alla Camera di Commercio. Per liberi professionisti non iscritti alla Camera di Commercio suggeriamo di utilizzare l’endpoint risk anagrafica per ottenere informazioni come sede, denominazione, codice e descrizione Ateco, domicilio fiscale ed informazioni personali.
La risposta viene restituita in tempo reale per tutti gli endpoint.
I parametri per effettuare una richiesta ai due endpoint sono gli stessi:
- partita iva
- codice fiscale
- id
La differenza è nei dati presenti nella risposta.
Nella risposta di GET Base sono presenti i seguenti dati:
- codice fiscale
- denominazione
- partita IVA
- toponimo
- via
- civico
- indirizzo completo
- comune
- frazione
- provincia
- stato attività
- data aggiornamento
- cap
- codice destinatario
- id azienda
- longitudine
- latitudine
- data iscrizione alla Camera di Commercio
Nella risposta di GET Advance, oltre a tutti i dati presenti nel base, sono disponibili:
- REA
- PEC
- Codice Natura Giuridica
- Codice e Descrizione ATECO
- Data inizio Attività
- Data Chiusura Bilancio, Fatturato, Utile (con storico fino a 5 anni)
- Dipendenti
- Capitale Sociale
- Gruppo IVA
- Stato dell'impresa presso l'Agenzia delle Entrate
- Soci (Denominazione / Nome, Codice Fiscale / percentuale quota)
L’endpoint Get /advance consente di trovare aziende in base a dei parametri che possono essere numero fatturato, dipendenti, codice ATECO, coordinate e raggio.
Nella risposta possono essere presenti una o più aziende in base ai parametri utilizzati in fase di richiesta. Per ogni singola azienda sono disponibili i seguenti dati:
- codice fiscale
- denominazione
- partita IVA
- toponimo
- via
- civico
- indirizzo completo
- comune
- frazione
- provincia
- stato attività
- data aggiornamento
- cap
- id azienda
- longitudine
- latitudine
- codice natura giuridica
- data iscrizione alla Camera di Commercio
Get /advance{piva_cf_or_id} invece richiede come parametro uno dei seguenti valori:
- partita IVA
- codice fiscale
- id azienda
La risposta riguarderà una sola azienda e restituirà i seguenti dati:
- codice fiscale
- denominazione
- partita IVA
- toponimo
- via
- civico
- indirizzo completo
- comune
- frazione
- provincia
- stato attività
- data aggiornamento
- cap
- codice destinatario
- id azienda
- longitudine
- latitudine
- data iscrizione alla Camera di Commercio
- REA
- PEC
- Codice Natura Giuridica
- Codice e Descrizione ATECO
- Data inizio Attività
- Data Chiusura Bilancio, Fatturato, Utile (con storico fino a 5 anni)
- Dipendenti
- Capitale Sociale
- Gruppo IVA
- Stato dell'impresa presso l'Agenzia delle Entrate
- Soci (Denominazione / Nome, Codice Fiscale / percentuale quota)
GET Advance consente di ottenere una lista di azienda con una serie di informazioni. Per ogni singola richiesta è stato impostato di default un limite massimo di 100 risultati. Nel caso in cui fossero a disposizione più di 100 risultati è possibile utilizzare il parametro SKIP per impostare il numero di record che si desidera saltare dal set di risultati.
Non esiste nessun limite al raggio indicato come parametro, ricordiamo però che il numero massimo di risultati per singola richiesta è pari a 100.
Dry run, skip e limit sono parametri facoltativi che possono essere inseriti in una richiesta al GET Advance:
- Dry Run consente di simulare una richiesta restituendo solo il numero di record trovati e il prezzo. In pratica indica quante imprese sono compatibili rispetto ai parametri utilizzati in fase di richiesta
- Skip invece permette di impostare il numero di record che si desidera saltare dal set di risultati
- Limit indica il numero di risultati massimo che si vuole ottenere nella risposta. Ricordiamo che di default la risposta include massimo 100 risultati.
Nella risposta del Get Advance è disponibile la sede legale dell’impresa.
Le informazioni sui soci sono disponibili tramite endpoint dedicato Get /soci o è presente anche nel dataset di risposta per l'endpoint Get Advance/{piva_or_cf}.
La risposta viene restituita in tempo reale ed include nome o denominazione, codice fiscale e quota in percentuale.
I soci presenti nell'elenco sono quelli che hanno una quota uguale o maggiore al 10% (le stesse informazioni si possono ottenere anche dal bilancio depositato, se è stato depositato negli ultimi 4 anni).
Per un dato più aggiornato e arricchito si può utilizzare anche l'endpoint GET /stakeholders dell'API Company, dove è possibile ottenere maggiori informazioni sui ruoli aziendali, anagrafici sui soci e sull'azienda in generale.
Sono due informazioni diverse e provengono da fonti ufficiali differenti.
Il campo stato attività indica lo status dell'azienda secondo la Camera di Commercio Italiana. I valori che possono essere presenti nella risposta sono:
- Attiva
- Registrata
- Inattiva
- Sospesa
- In Iscrizione
- Cessata
Il campo cessata indica invece lo stato dell’azienda presso l’Agenzia delle Entrate. In questo caso i valori disponibili sono:
- True
- False
No, l’API Imprese non prevede rate limit giornalieri.
L’aggiornamento dipende dalla tipologia del dato e dall’endpoint.
Il dato presente nell’endpoint Cessate e SdI è aggiornato quotidianamente. Le aziende nuove e cessate sono aggiornate entro 24 ore. I dati come fatturato, utile e PEC vengono aggiornati in media settimanalmente e possono avere un ritardo massimo di 1 mese. Il dato dipendenti è aggiornato trimestralmente.
Tutti i dati presenti nelle risposte dell’API Imprese provengono da fonti ufficiali e certificate e database pubblici tramite licenza TULPS, come ad esempio Camera di Commercio, INPS, Agenzia delle Entrate.
Si, è possibile accedere ad ulteriori informazioni tramite l’API Company, dove sono disponibili oltre 400 dati sulle singole aziende, su dipendenti e di marketing.
Imprese e Company offrono entrambe informazioni su aziende italiane.
Imprese consente di effettuare un rapido check su un'impresa e offre il dataset essenziale per una fatturazione senza problemi. Presenta informazioni come ad esempio stato attività (CCIAA), stato in Agenzia Entrate, Fatturato, Utili, Dipendenti, etc. Inoltre mette a disposizione una serie di endpoint per ottenere dati specifici, come codice destinatario, PEC, gruppo IVA.
Con Company invece si accede ad un dataset molto più ampio, fino a 400 dati, per effettuare un'analisi dettagliata dell'azienda, dei soggetti che ne prendono parte e per accedere a tutti i contatti ed informazioni per pianificare attività di marketing.
Sì, per gli endpoint Get pec, base, closed e soci sono previste 30 richieste al mese. Per maggiori informazioni ti invitiamo a consultare la sezione Prezzi.
Il costo delle singole richieste dipendono dall’endpoint e sono da 0,001€ fino a 0,10€. Tutti i prezzi delle singole richieste (prezzi base) sono disponibili nella sezione Prezzi dove viene indicato anche se sono disponibili abbonamenti e la percentuale di risparmio.
È possibile attivare l’abbonamento nella sezione dedicata, indicando la durata dell’abbonamento (mese / anno), selezionando il numero di richieste e la data di decorrenza. Una volta completato il pagamento le richieste saranno immediatamente disponibili (potete anche decidere di far partire un abbonamento in una data successiva). Per pagamento con bonifico, le richieste saranno disponibili ad accredito dell’importo.
Solo per alcuni servizi che sono soggetti al TULPS e relativa licenza (articolo 6 della licenza TULPS) è previsto l'obbligo di identificazione tramite documento di identità della persona o azienda che richiede il servizio stesso.
Per alcuni servizi la normativa TULPS prevede l'identificatore dell'utilizzatore del servizio.
Nel caso di società quindi viene richiesto di caricare un documento di identità (patente, passaporto, carta d'identità) che può essere o del legale rappresentante o di una persona con poteri di firma o un delegato per l'erogazione e l'utilizzo del servizio specifico (es. responsabile IT o ufficio amministrativo)
Nella sezione Utilizzo è possibile monitorare le richieste gratuite ed effettuate tramite abbonamento o ricarica.
Sono disponibili sia in modalità grafica (periodo mese e anno), sia con un riepilogo testuale.