Il servizio “Cerca Imprese Soci” permette di avere a disposizione la lista dei soci di un’azienda italiana.

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

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

Attraverso questo service è possibile ottenere le seguenti informazioni:

• Denominazione per Aziende
• Nome e Cognome per privati
• Codice fiscale
• Percentuale della quota 

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

La risposta è in tempo reale. Nell'elenco sono presenti soci sia di tipo persona privata che giuridica. A differenza del Report Composizione Societaria erogato sempre tramite API ma in formato PDF, i dati di questo servizio sono disponibili esclusivamente tramite JSON.

ESEMPIO CHIAMATA GET /soci/{piva_cf_or_id}

Ecco un esempio di chiamata effettuata con il parametro Partita IVA 12485671007:

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

ESEMPIO RISPOSTA GET /soci/{piva_cf_or_id}

Questo è un esempio dei dati sui soci che puoi ottenere a partire dalla Partita IVA:

{
  "data": [
    {
      "denominazione": "OPEN HOLDING S.R.L.",
      "nome":null,
      "cognome"null,
      "cf_socio"16935371001,
      "valore": "100"
    },
  "success": true,
  "message": "",
  "error": null
}

Nel caso specifico il risultato è solo uno (quota 100%) e la tipologia di socio è persona giuridica ed è per questo motivo che è compilato solo il campo denominazione e non nome e cognome.

Le informazioni fornite sono in particolare:

• Denominazione 
• CF socio
• Quota

I dati soci sono sono disponibili anche nel Cerca Imprese Advance Partita IVA che include tutte le principali informazioni su un'azienda come ad esempio Fatturato, Utile, Ultimi 3 bilanci, dipendenti, PEC:

{
  "data": {
    "cf": "12485671007",
    "denominazione": "OPENAPI S.R.L.",
    "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": 1681376096,
    "dettaglio": {
      "rea": "1378273",
      "cciaa": "RM",
      "codice_ateco": "6201",
      "descrizione_ateco": "Produzione di software non connesso all'edizione",
      "codice_natura_giuridica": "SR",
      "data_inizio_attivita": "2013-10-20",
      "pec": "[email protected]",
      - "bilanci": {
       + "2017": {...},
       + "2018": {...},
       + "2019": {...},
       + "2020": {...},
       - "2021":  {
	        "dipendenti":15,
          "capitale_sociale": 50000,
          "data_chiusura_bilancio":"2021-12-31",
          "fatturato": 4432761,
	        "utile": 469366
   },
      + "2022": {...},
      + "2023": {
        "dipendenti":15,
        "capitale_sociale": 50000
    }
	 },
	- "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"
    }
  ]
},  
    "codice_destinatario": "MJ1OYNU",
    "timestamp_creation": 1624358855,
    "timestamp_last_update": 1676878023,
    
    "gps": {
     "coordinates": [
        12.47843,
       41.8071
     ]
    },
    "cap": "00143",
    "data_iscrizione": "2013-07-19"
    "id": "60b4a85585e34e615c569ef5"
  },
  "success":  true,
  "message": "",
  "error":  null
 }

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).

Chi vuole avere tutti i gli stakeholder sempre aggiornati può utilizzare "Stakeholders" del service Company.

Altri endpoint disponibili per il 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 Advance Partita IVA per ottenere informazioni dettagliate su un’azienda
• 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 Base per ottenere informazioni specifiche sulle aziende italiane
• 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
• Cerca Imprese Updates per avere l'elenco di tutti gli id delle aziende per cui sono state registrate delle modifiche