Da: 0,095 € + IVA
Il servizio Stakeholder appartiene all'API Company ed è pensato per tutte le società che vogliono accedere a dati certificati e dettagliati su Dirigenti, Soci, Amministratore Legale e Dipendenti di un'impresa tramite API
Il servizio Stakeholders Company appartiene all'API Company ed è pensato per tutte le società che vogliono accedere a dati certificati e dettagliati su amministratore legale, soci ed in generale su tutti i soggetti che hanno un incarico nell'azienda.
Di ogni singolo soggetto sono disponibili dati come:
Per quanto riguarda i soci, è possibile accedere alla lista dei primi 10 e conoscere anche le rispettive quote di proprietà. Il dataset è poi arricchito da informazioni sui dipendenti come ad esempio numero, trend rispetto all'anno precedente, tipologia di contratto.
Il servizio è attualmente disponibile sia nella modalità sincrona che asincrona.
Durante periodi di traffico elevato, le fonti ufficiali di dati potrebbero subire rallentamenti nei tempi di risposta, pertanto se non necessario suggeriamo di implementare il metodo POST.
Questo metodo consente di impostare una URL di callback, così da eliminare la necessità di controllare lo stato e sfruttare l'opportunità che offre il nostro sistema di ricevere una notifica proattivamente al completamento della richiesta.
L'endpoint di riferimento è https://company.openapi.com/IT-stakeholders/{vatCode_or_taxCode}
POST /IT-stakeholders
Questo è un esempio di richiesta in cui è stato utilizzato il parametro partita IVA: 12485671007
https://company.openapi.com/IT-stakeholders/12485671007
Come indicato precedentemente sarà possibile anche impostare una callback tramite il payload:
{
"callback": {
"url": "https://your_domain.it/your_callback.php",
"method": "JSON",
"headers": {
"session_id": "oiwejdf89453urf945jfg"
}
}
POST /IT-stakeholders
La risposta includerà l'id della richiesta e lo stato
{
"callback": {
"data": {
"state": "PENDING",
"id": "66a8ed9b82cf2ae627012068"
},
"success": true,
"message": "",
"error": null
}
E' possibile verificare lo stato della richiesta in qualsiasi momento tramite l'endpoint /IT-check_id/{id}. In caso di impostazione della callback il sistema notificherà direttamente quando la risposta sarà disponibile.
GET/IT-check_id/{id}
https://company.openapi.com//IT-check_id/66a8ed9b82cf2ae627012068
Nel caso lo stato della richiesta è stato completato, e cioè si trova in done, la risposta includerà tutti dati:
{
"data": {
"managers": [
{
"name": "LUCA",
"surname": "SCURIATTI",
"roles": [
{
"role": {
"code": "AUN",
"description": "Managing director"
},
"roleStartDate": "2020-09-10T00:00:00"
}
],
"gender": {
"code": "M",
"description": "Man"
},
"taxCode": "SCRLCU73R02H501H",
"birthDate": "1973-10-02T00:00:00",
"age": 49,
"birthTown": "ROMA (RM)",
"isLegalRepresentative": true
},
{
"companyName": "OPEN HOLDING SRL",
"roles": [
{
"role": {
"code": "SOU",
"description": "Sole owner"
},
"roleStartDate": "2022-12-05T00:00:00"
}
],
"taxCode": "16935371001",
"isLegalRepresentative": false
},
{
"name": "SIMONE",
"surname": "DESANTIS",
"roles": [
{
"role": {
"code": "PP",
"description": "Special representative/agent"
},
"roleStartDate": "2013-10-17T00:00:00"
}
],
"gender": {
"code": "M",
"description": "Man"
},
"taxCode": "DSNSMN80M11L117F",
"birthDate": "1980-08-11T00:00:00",
"age": 42,
"birthTown": "TERNI (TR)",
"isLegalRepresentative": false
},
{
"name": "SHAUN",
"surname": "DE LUCIA",
"roles": [
{
"role": {
"code": "PP",
"description": "Special representative/agent"
},
"roleStartDate": "2013-10-17T00:00:00"
}
],
"gender": {
"code": "M",
"description": "Man"
},
"taxCode": "DLCSHN77S29Z114J",
"birthDate": "1977-11-29T00:00:00",
"age": 45,
"birthTown": "STOKE ON TRENT (E)",
"isLegalRepresentative": false
}
],
"shareholders": [
{
"shareholdersInformation": [
{
"taxCode": "16935371001",
"openapiNumber": "IT8A380807S0001",
"companyName": "OPEN HOLDING SRL",
"sinceDate": "2022-11-23T00:00:00",
"streetName": "VIALE FILIPPO TOMMASO MARINETTI 221"
}
],
"percentShare": 100
}
],
"companyDetails": {
"vatCode": "12485671007",
"taxCode": "12485671007",
"lastUpdateDate": "2023-03-08T11:25:08.0331456Z",
"cciaa": "RM",
"reaCode": "1378273",
"companyName": "OPENAPI SRL",
"officeType": {
"code": "SSL",
"description": "Administrative headquarter and registered office"
},
"openapiNumber": "IT93E20F0DS0001"
},
"address": {
"streetName": "VIALE FILIPPO TOMMASO MARINETTI, 221",
"zipCode": "00143",
"town": "ROMA",
"province": {
"code": "RM",
"description": "ROMA"
},
"region": {
"code": "12",
"description": "LAZIO"
},
"country": {
"code": "IT",
"description": "Italia"
}
},
"branches": {
"numberOfBranches": 1
"employees": {
"employeeRange": {
"code": "ER4",
"description": "11 - 20"
},
"employee": 15,
"employeeTrend": 7.14
},
"employeesStatistic": {
"permanentContract": 100,
"partialTimeContract": 20,
"fullTimeContract": 80,
"whiteCollar": 100
},
"corporateGroups": {
"belongsToGroup": true,
"groupName": "DE LUCIA - SCURIATTI",
"holdingCompanyName": "LUCA SCURIATTI",
"nationalParentCompany": {
"province": {
"code": "ND99",
"description": "N. A."
}
}
}
},
"success": true,
"message": "",
"error": null
}
Come indicato Stakeholders Company è disponibile anche in modalità sincrona. L'endpoint da utilizzare è /IT-stakeholders/{vatCode_or_taxCode} ma in questo caso il metodo sarà GET. La risposta verrà restituita in media in pochi secondi
Durante periodi di traffico elevato, le fonti ufficiali di dati potrebbero subire rallentamenti nei tempi di risposta. In questi periodi di picco di carico o di manutenzione, abbiamo previsto un Timeout di 30 secondi per le richieste sincrone. Dopo il Timeout, viene generato un ID univoco che consente ai clienti di richiedere aggiornamenti sullo stato e per ottenere la risposta quando sarà disponibile tramite l'endpoint dedicato GET company.openapi.com/IT-check_id
Il servizio Stakeholders Company è utilizzato da aziende che voglio conoscere in maniera approfondita tutti i soggetti coinvolti nell'organizzazione dell'azienda. Alcuni esempi di tipologie di aziende che già utilizzano il servizio Stakeholders sono banche, investitori e venture capital, concorrenti, partner commerciali e fornitori, società di consulenza e ricerca di mercato, aziende di recruting.
Hai bisogno di aiuto?
Non hai trovato la risposta che cercavi?
Compila tutti i campi, ti ricontatteremo al più presto!
Il servizio di Stakeholders Company offre informazioni dettagliate su dirigenti, soci e dipendenti di un'impresa tramite API. Consente di accedere a dati chiave riguardanti la struttura organizzativa e le figure professionali all'interno di un'azienda. Questo servizio è particolarmente utile per analisi di mercato, valutazioni di rischio e decisioni strategiche. Grazie alla sua facilità di integrazione, permette alle aziende di migliorare la gestione delle informazioni relative ai propri stakeholder.
Per ogni singolo soggetto, sono disponibili informazioni dettagliate quali:
Per quanto riguarda i soci, è possibile anche conoscere:
Nota bene: è possibile visualizzare solo l'elenco dei primi 10 soci.
Inoltre, il dataset è arricchito da informazioni sui dipendenti, tra cui:
Sì, sono certificati e aggiornati costantemente.
Elenco Soci (Shareholders):
Stakeholders Company:
In sintesi, Elenco Soci (Shareholders) è limitato ai proprietari delle quote di un'azienda, mentre Stakeholders Company offre una panoramica più ampia su tutti gli attori rilevanti all'interno dell'azienda
Il servizio Stakeholders Company è pensato per diverse categorie di professionisti e organizzazioni, tra cui:
È particolarmente utile per chi necessita di informazioni dettagliate e aggiornate su dirigenti, soci e dipendenti di aziende, come coloro che valutano l'affidabilità o il profilo di un'impresa, o che devono gestire processi di due diligence e analisi di mercato.
Le informazioni sono fornite tramite API in tempo reale, garantendo un accesso immediato ai dati richiesti.
È possibile optare per abbonamenti che offrono tariffe più convenienti, con prezzi a partire da €0,095 + IVA per richiesta. Gli abbonamenti prevedono limiti di utilizzo, variabili a seconda del tipo di abbonamento scelto, garantendo maggiore flessibilità in base alle esigenze. In alternativa, il costo per ogni singola richiesta tramite ricarica è di €0,20 + IVA.