Stakeholders Company
0,20 € + 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 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:
- Nome
- Cognome
- Ruolo
- Inizio di entrata in attività
- Età
- Codice Fiscale
- Data e luogo di nascita.
Per quanto riguarda i soci, è possibile conoscere anche la quota 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}
ESEMPIO RICHIESTA
POST /IT-stakeholders
Questo è un esempio di richiesta in cui è stato utilizzato il parametro partita IVA: 12485671007
https://company.openapi.com/IT-stakeholders/12485671007Come 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"
}
}ESEMPIO RISPOSTA
POST /IT-stakeholders
La risposta includerà l'id della richiesta e lo stato
{
"callback": {
"data": {
"state": "PENDING",
"id": "66a8ed9b82cf2ae627012068"
},
"success": true,
"message": "",
"error": null
}VERIFICA STATO RICHIESTA
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.
ESEMPIO RICHIESTA
GET/IT-check_id/{id}
https://company.openapi.com//IT-check_id/66a8ed9b82cf2ae627012068ESEMPIO RISPOSTA
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 è 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 è 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.
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:
- Nome
- Cognome
- Ruolo
- Data di inizio attività
- Età
- Codice fiscale
- Data e luogo di nascita
Per quanto riguarda i soci, è possibile anche conoscere:
- Quota di proprietà
Inoltre, il dataset è arricchito da informazioni sui dipendenti, tra cui:
- Numero totale di dipendenti
- Trend rispetto all'anno precedente
- Tipologia di contratto.
Sì, sono certificati e aggiornati costantemente.
Si il nostro è servizio sincrono (in GET). Per renderlo ancora più efficiente e performante, nei casi in cui si verifichino dei ritardi, viene rilasciato un ID richiesta così da evitare i rischi di Timeout. Lo stesso ID può poi essere utilizzato per ottenere la risposta tramite un endpoint dedicato, in modalità asincrona.
Il servizio Stakeholders Company è pensato per diverse categorie di professionisti e organizzazioni, tra cui:
- Banche
- Investitori
- Consulenti
- Aziende di reclutamento.
È 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.
