Partecipazioni in Società è parte del servizo Search dell'API Company e consente di ottenere l'elenco delle imprese in cui un soggetto, privato o giuridico, possiede quote.

La risposta è fornita in json in tempo reale.

ESEMPIO RICHIESTA GET /IT-search

Questo è un esempio di richiesta per la partita iva: 16935371001

https://company.openapi.com/IT-Search?dataEnrichment=start&shareHolderTaxCode=16935371001

La richiesta può essere effettuta su soggetto giuridico (parametro partita IVA o codice fiscale) o su soggetto privato (parametro codice fiscale).

 
ESEMPIO RISPOSTA GET /IT-search

La risposta dipende dal valore impostato per il parametro "dataEnrichment":

• Nessun parametro: se non viene specificato verrà restituito un elenco di id delle aziende che possono essere usati per richiedere informazioni tramite gli altri endpoint di Company
• Start: restituirà per ogni impresa corrispondente ai parametri tutte le informazioni dell'endpoint start: denominazione, codice fiscale, partita iva, indirizzo, sede, stato attività, sdi
• Advanced: si comporterà nella stessa modalità di start ma offrirà informazioni arricchite come ad esempio  PEC codice SdI, REA, Natura Giuridica, ATECO, fatturato, utili, dipendenti, soci

Questo è un esempio di risposta (start):

• Codice Fiscale
• Denominazione
• Partita IVA
• Sede Legale (toponimo, via, indirizzo, comune, frazione, provincia, CAP)
• Coordinate Geografiche Sede Legale (longitudine e latitudine)
• Codice Catastale sede
• Codice Sdi e aggiornamento
• Stato Attività
• Timestamp creation (data creazione azienda in database)
• Timestamp last update (data ultima variazione dell’impresa)
• Data iscrizione alla Camera di Commercio
• Identificativo azienda interno (ID)

Questa risposta è a titolo di esempio ed i dati non sono corrispondenti ai parametri indicati nella richiesta: 

{
"data": [
  {
    "taxCode": "12485671007",
    "companyName": "OPENAPI S.R.L.",
    "vatCode": "12485671007",
    "address":{
      "registeredOffice": {
      "toponym": "VIALE",
      "street": "F TOMMASO MARINETTI",
      "streetNumber": "221",
      "streetName": "VIALE F TOMMASO MARINETTI 221",
      "town": "ROMA",
      "hamlet":  null,
      "province": "RM",
      "zipCode": "00143",
      "gps": {
        "coordinates": [
          12.47843,
          41.8071
       ]
      },
      "townCode": "H501"
    }
  },
  "activityStatus": "ATTIVA",
  "creationTimestamp": 1676878023,
  "lastUpdateTimestamp": 1676878023,
  "sdiCode": "MJ1OYNU",
  "sdiCodeTimestamp": 1624358855,
  "id": "60b4a85585e34e615c569ef5",
  "registrationDate: "2013-07-19"
  },
{
  "taxCode": "12345678910",
  "companyName": "OPENAPI TEST S.P.A.",
  "vatCode": "12345678910",
  "address":{
    "registeredOffice": {
    "toponym": "VIALE",
    "street": "ROMA",
    "streetNumber": "221",
    "streetName": "VIALE ROMA 221",
    "town": "ROMA",
    "hamlet":  null,
    "province": "RM",
    "zipCode": "00143",
      "gps": {
        "coordinates": [
         13.47866,
          41.9072
        ]
      },
      "townCode": "H501",
    }
  },
  "activityStatus": "REGISTRATA",
  "creationTimestamp": 1676878023,
  "lastUpdateTimestamp": 1676878023,
  "sdiCode": "USAL8PV",
  "sdiCodeTimestamp": 1624358855,
  "id": "45d1bfc788174b9u092cdtr5",
  "registrationDate: "2016-08-29"
    }
 ],
 "success":  true,
 "message": "",
 "error":  null
 }

Nella risposta sono presenti solo le aziende dove i soggetti hanno una quota uguale o maggiore al 10% e che hanno presentato il bilancio nei precedenti anni.