Il service fornisce con una sola chiamata ed in tempo reale tutti i dati anagrafici di un’impresa, le informazioni sull'attività, i componenti e i dati economici.

Tutti i dati sono disponibili a partire da uno dei seguenti parametri:

• Partita Iva 
• Codice Fiscale
• ID (identificativo interno dell’azienda)

1) Cerca Imprese Base GET/base/{piva_cf_or_id}

Il servizio Cerca Imprese Base consente di ottenere tutti i dati anagrafici di un’impresa e verificarne lo stato di attività.

Con Cerca Imprese Base puoi avere, dalla partita iva o codice fiscale o ID azienda, i seguenti dati: 

• Codice Fiscale
• Denominazione Sociale Completa
• Partita IVA
• Sede Legale (toponimo, via, civico, indirizzo, città, frazione, provincia, CAP)
• Stato Attività (Attiva, Registrata, Inattiva, Sospesa, In Iscrizione, Cessata)
• Timestamp (utilizzo interno) 
• Timestamp creation (data creazione azienda in database)
• Timestamp last update (data ultima variazione dell’impresa)
• Codice destinatario per la fatturazione elettronica
• id (identificato interno azienda)
• Coordinate GPS (longitudine e latitudine)
• Data Iscrizione alla Camera di Commercio

Il Cerca Imprese Base è identificato dall’endpoint: GET https://imprese.openapi.it/base/{piva_cf_or_id}

I dati sulle nuove aziende e le risposte sono fornite in tempo reale.

ESEMPIO RICHIESTA GET Imprese Base

Questo è un esempio di richiesta per la partita IVA 12485671007:

https://imprese.openapi.it/base/12485671007

ESEMPIO RISPOSTA  GET Imprese Base

Questo invece è un esempio della risposta ottenuta utilizzando come parametro la partita IVA 12485671007:

{
  "data": {
    "cf": "12485671007",
    "denominazione": "ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' LIMITATA",
    "piva": "12485671007",
    "toponimo": "VIALE",
    "via": "F TOMMASO MARINETTI",
    "civico": "221",
    "indirizzo": "VIALE F TOMMASO MARINETTI 221",
    "comune": "ROMA",
    "frazione":  null,
    "provincia": "RM",
    "stato_attivita": "ATTIVA",
    "timestamp": 1622452306,
    "timestamp_creation": 1622452306,
    "timestamp_last_update": 1622452306,
    "cap": "00143",
    "codice_destinatario": "MJ1OYNU",
    "id": "60b4a85585e34e615c569ef5"
    "gps": {
     "coordinates": [
       12.47843,
       41.8071
     ]
    }
   },
  "success": true,
  "message": "",
  "error": null
  }

Cerca Imprese è la soluzione implementata ad esempio da decine di ecommerce per ottimizzare i tempi di compilazione form / checkout dei clienti business ed eliminare qualsiasi errore di fatturazione. Dopo che l'utente business ha inserito la partita IVA, all'interno nel form di acquisto vengono automaticamente compilati i restanti campi di fatturazione.

2) Cerca Imprese Advance P.IVA GET/advance/{piva_cf_or_id}

Il servizio Cerca Imprese Advance offre il dataset più completo di informazioni aziendali di questo service e consente, sempre dal parametro partita iva / codice fiscale o id di un'impresa, di ottenere tutte le informazioni di un'azienda presenti nel Cerca Imprese Base più ulteriori informazioni come ad esempio codice REA, CCIAA, Codice e Descrizione ATECO, Fatturato, Utili e Dipendenti.

Cerca Imprese Advance P. IVA, oltre alle informazioni presenti nel Base, include:

• Indirizzo PEC e Domicilio Digitale
• Codice REA
• Camera di Commercio (CCIAA) di Iscrizione
• Codice Natura Giuridica
• Codice e Descrizione ATECO (Attività Economica)
• Capitale Sociale
• Data Chiusura Bilancio degli ultimi 3 anni
• Fatturato Ultimi 3 anni
• Utile Ultimi 3 anni
• Dipendenti Ultimi 5 anni (se disponibili)
• Soci (Nome e Cognome / Denominazione e quota dei Soci che detengono una partecipazione pari o superiore al 10%)*
• Appartenenza ad un Gruppo IVA

Il Cerca Imprese Advance P. IVA è identificato dall’endpoint: GET https://imprese.openapi.it/advance/{piva_cf_or_id}

La risposta è in tempo reale.

ESEMPIO RICHIESTA GET Imprese Advance 

Questo è un esempio di richiesta per la partita IVA 12485671007:

https://imprese.openapi.it/advance/12485671007

ESEMPIO RISPOSTA GET Imprese Advance

Questo è un esempio della risposta ottenuta utilizzando come parametro la partita IVA 12485671007:

{
  "data": {
    "cf": "12485671007",
    "denominazione": "ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' LIMITATA",
    "piva": "12485671007",
    "toponimo": "VIALE",
    "via": "F TOMMASO MARINETTI",
    "civico": "221",
    "indirizzo": "VIALE F TOMMASO MARINETTI 221",
    "comune": "ROMA",
    "frazione":  null,
    "provincia": "RM",
    "stato_attivita": ""ATTIVA",
    "timestamp": 1622452306,
    "timestamp_creation": 1622452306,
    "timestamp_last_update": 1622452306,
    "dettaglio": {
      "rea": "1378273",
      "cciaa": "RM",
      "pec": "[email protected]",
      "codice_natura_giuridica": "SR",
      "descrizione_ateco": "Produzione di software non connesso all'edizione",
      "codice_ateco": "6201",
      "data_inizio_attivita": "2013-10-20",
      - "bilanci": {
       + "2017": {...},
       + "2018": {...},
       - "2019":  {
	   "data_chiusura_bilancio":"2019-12-31",
	   "fatturato": 1799587,
	   "utile": 11309,
	   "dipendenti":14,
	   "capitale_sociale": 10000
	 }
	 },
	- "gruppo_iva": {
	   "partecipazione": false,
	   "piva_capogruppo": false,
	      "anagrafica_ok": true
	  },
	"cessata":  false,
  "soci": [
    {
      "denominazione": "OPEN HOLDING S.R.L.",
      "nome":null,
      "cognome"null,
      "valore": "100"
    }
  ]
},  
    "cap": "00143",
    "codice_destinatario": "MJ1OYNU",
    "id": "60b4a85585e34e615c569ef5",
    "gps": {
     "coordinates": [
        12.47843,
       41.8071
     ]
    }
  },
  "success":  true,
  "message": "",
  "error":  <null
 }

Molte imprese di Business intelligence lo utilizzano per avere dettagli su un’impresa.

Sempre con il service Cerca Imprese è possibile inoltre verificare quali aziende hanno registrato variazioni in un arco di tempo definito.

Gli endpoint disponibili sono 2:

1) Cerca Imprese Updates GET/updates

Il servizio "Updates" consente di ottenere l'elenco di tutti gli id delle aziende per cui si sono verificate modifiche negli ultimi 6 mesi.

I parametri per effettuare la ricerca sono:

• latitudine e longitudine
• raggio

ESEMPIO RICHIESTA GET Imprese Updates

Questo è un esempio di chiamata con i parametri latitudine 13.5478, longitudine 42.859, raggio 1000 (metri) e con un limite di risultati pari 3:

https://imprese.openapi.it/updates?lat=13.5478&lng=42.859&radius=1000&skip=0&limit=3&dry_run=0

ESEMPIO RISPOSTA GET Imprese Updates

Il risultato sarà un elenco di ID aziende per cui sarà possibile effettuare chiamate con gli endpoint Base / Advance per ottenere tutti i dati aggiornati. 

Questo è un esempio della risposta in cui sono state individuate 3 aziende:

{
  "data": [
    {
      "id": "61f2c4d69fb8571d19235463"
    },
    {
      "id": "61f4r5y69fb8571d19237859"
    },
    {
      "id": "61f2f6t09fb8571d19237773"
    }
    ],
  "success": true,
  "message": "",
  "error": null
}

2) Cerca Imprese Updates GET /updates{timestamp}

L’endpoint GET /updates/{timestamp} consente di limitare la ricerca a partire da una data ben definita e non genericamente negli ultimi 6 mesi.

ESEMPIO RICHIESTA GET Imprese Updates{timestamp}

Questo è un esempio di chiamata con i parametri latitudine 13.5478, longitudine 42.859, raggio 1000 (metri) e con un limite di risultati pari 3 però con il timestamp 1682936900 (convertita in data è 1/5/2023 ore 12:28:20). In pratica sto effettuando la stessa chiamata di prima ma con il parametro “timestamp” indico che desidero ottenere solo le aziende aggiornate successivamente al 1/5/2023 ore 12:28:20:

https://imprese.openapi.it/updates/1682936900?lat=13.5478&lng=42.859&radius=100&skip=0&limit=3&dry_run=0

ESEMPIO RISPOSTA GET Imprese Updates{timestamp}

Questo è un esempio della risposta in cui, in questo caso, sono riportati 2 ID aziende:

{
  "data": [
    {
      "id": "61f2c4d69fb8571d19235463"
    },
    {
      "id": "61f2f6t09fb8571d19237773"
    }
    ],
  "success": true,
  "message": "",
  "error": null
}

Per entrambe le chiamate Updates sono disponibili i parametri “limit” / “skip”.
Con il parametro "limit" è possibile indicare il numero massimo di risultati desiderati. Invece con "skip" è possibile impostare il numero di risultati da saltare. Questo secondo parametro è stato implementato per "saltare" eventuali risultati ottenuti da ricerche precedenti.

Altri Endpoint del Service Cerca Imprese

Il service Cerca Imprese permette attraverso altri endpoint di ottenere singole informazioni già presenti nel Cerca Imprese Base e Advance:

• Cerca Imprese Advance (Elenco) per ottenere un elenco di imprese in base ad una serie di parametri come codice ATECO, fatturato, CCIAA, dipendenti
• Cerca Imprese Attiva/Chiusa per verificare lo stato di un’azienda
• Cerca Imprese Autocomplete per ottenere un elenco di nomi di aziende a partire da una ricerca parole
• Cerca Imprese Forma Giuridica per ottenere l'elenco e il codice di tutte le forme giuridiche d'impresa
• Cerca Imprese Gruppo IVA per verificare se un'impresa appartiene ad Gruppo IVA
• Cerca Imprese PEC per scoprire la PEC di un’azienda
• Cerca Imprese Soci per ottenere l’elenco dei soci di un’impresa

Le chiamate gratuite sono utilizzabili sia per GET /imprese.openapi.it/base che per GET  /imprese.openapi.it/advance.

*L'elenco soci è disponibile per le aziende che hanno depositato il bilancio negli ultimi 4 anni ed include privati e persone giuridiche che detengono una quota superiore al 10%. Per avere tutti gli stakeholder sempre aggiornati usare "Stakeholders" del service Company.