€2.30 + VAT
Obtain data on individual company members, such as name and residence, starting from the tax code, VAT number, or company ID.
The Current Company Shareholders service allows you to obtain, starting from a single parameter (VAT number, tax code, or ID) of the company:
The request can be made using the VAT number, tax code, or company ID. Requests can only be made for joint-stock or partnership companies registered with the Chamber of Commerce.
GET /soci-attivi
The data to include in the request are: VAT Number / Company ID.
{
"data": {
"cf_piva_id": "12485671007",
"callback": false,
"url": "https://your_site.com/file_callback.php",
"method": "POST"
"field": "data"
}
}
At this stage, it is possible to set a callback to be updated on the status change of the request.
The response will include all the submitted information along with the request status and ID.
{
"data": {
"cf_piva_id": "12485671007",
"json_soci": null,
"tipo": "soci-attivi",
"stato_richiesta": "In progress",
"timestamp_creation": 1649683350,
"timestamp_last_update": 1649683350,
"attachments": [],
"callback": false,
"url": "https://your_site.com/file_callback.php",
"method": "POST"
"owner": "[email protected]",
"field": "625fec9313ddfc09f11c47e2"
},
"owner": "[email protected]",
"id": "625fec9313ddfc09f11c47e2"
},
"message": "",
"success": true,
"error": null
}
GET /soci-attivi/{id}
This method allows you to check the request identified by the ID created using the "Generate request" method.
The call provides access to the full request object, including status, timestamp, attachments, etc.
Below is a code snippet of a request for an active shareholders report.
{
"data": {
"cf_piva_id": "12485671007",
"json_soci": {
"company": {
"cciaa": "12485671007",
"rea_number": "12485671007",
"name": "12485671007",
"tax_code": "12485671007",
"vat_number": "12485671007",
"legal_nature_code": "SR",
"legal_form": "LIMITED LIABILITY COMPANY",
"address": {
"street_code": "VLE",
"street_type": "VIALE",
"street_name": "F TOMMASO MARINETTI",
"house_number": "221",
"postal_code": "00143",
"municipality_code": "RM091",
"istat_municipality_code": "H501",
"municipality": "ROME",
"district": null,
"province": "RM",
"country": "ITALY"
},
"ateco_codes" [
{
"ateco_code": "6201",
"ateco": "Software production not related to publishing"
}
],
"activity_status": "ACTIVE",
"start_date": "2013-10-20",
"end_date": null,
"share_capital": null,
"undetermined_rights_present": null,
"undetermined_shares": null,
"shares": []
},
"shareholders": [
{
"name": "SCXXXXX XXXA",
"individual": true,
"tax_code": "SCRXXXXXH501H",
"birth_date": "1973-10-02",
"birth_province": "RM",
"birth_city": "ROME",
"birth_city_code": "RM091",
"birth_city_istat_code": "H501",
"birth_country": "ITALY",
"gender": "MALE",
"shares": [
{
"deed_date": "2021-09-10",
"filing_date": "2021-09-15",
"protocol_date": "2021-09-15",
"right_type_code": "01",
"right_type_description": "OWNERSHIP",
"real_right": true,
"shares_number": null,
"share_type_code": null,
"share_type_description": null,
"share_value": 30000,
"ownership_percentage": 60,
"undetermined_share": false
}
],
"other_companies_with_shares": null,
"surname": "SCXXXXX",
"first_name": "XXXA"
}
]
},
"type": "active-shareholders",
"request_status": "Report completed",
"timestamp_creation": 1700582150,
"timestamp_last_update": 1700607890,
"attachments": [
"658eb8397e995e5d3602df7a.xml",
"658eb8397e995e5d3602df7a.pdf",
"658eb8397e995e5d3602df7a.json"
],
"callback": {
"url": "https://www.your_url.it/callback",
"method": "POST",
"field": "data",
"data": {}
},
"owner": "[email protected]",
"id": "658eb839e5a329399f6bffb2"
},
"success": true,
"message": "",
"error": null
}
GET /soci-attivi/{id}/attachments
Once the request status is "completed", it will be possible to download the report as a zip file.
The document can be downloaded as a zip file, and inside the document is in PDF format.
{
"data": {
"name": "625fec93fb8ca84347057795.zip",
"size": 586660,
"file": "UEsDBBQAAAAIABFOllTBs6lJ1vIIAJthCQAcABwANjI1ZmVjOTNmYjhjYTg0MzQ3MDU3Nzk1LnBkZlVUCQAD8nliYvJ5YmJ1eAsAAQQhAAAABCEAAACMvFO0ME0PNfgc27Zt27Zt27Zt27Zt27Zt+5x5v39mruZm7tLpZNfu6qyqpFZ3SOSFRWkYaNkgScau4w/HOUbc+WLQqnnTtt27Zt27Zt25k7bdu2bdvcadv5fnXOqapz655qt9p93x/vW62tFjHnGmv2HiMiZvQxY7RJIi8sSsNAywxFcnA4uwjFgE+Pb2doCcXNTSdqYe1s4kgnam3gbCJsYmRnbEInbWJr5"
},
"success": true,
"message": "",
"error": null
}
All formats (JSON, PDF, XML) will be available inside the zip file.
GET /soci-attivi
Finally, it is possible to check previously made requests, along with their details.
Do you need help?
Haven't found the answer you're looking for?
Fill in all the details, we will get back to you as soon as possible!
The Company Current Partners Report provides detailed information on the current shareholders of a company, starting from the company's VAT number or tax code. The report includes data such as name, tax code, place of birth, residence, and the participation share of each shareholder. This tool is useful for obtaining a comprehensive overview of the company's structure and active holdings.
The Soci Attivi Azienda service allows you to obtain detailed information about a company starting from a single parameter, such as the tax code, VAT number, or company ID. The report provides:
On Openapi, you can request Shareholder Reports through two different APIs:
The information is available in various formats, depending on the user's needs. Data can be obtained in PDF format, ideal for immediate and simple viewing, or in structured formats like JSON or XML, which are particularly useful for automatic integration into IT systems or for data processing through specific software.
The Company Current Partners Report is designed for various professionals and organizations that need detailed information on a company's corporate structure, including:
The information is provided via API in real time, ensuring immediate access to the requested data.
The cost of the Company Current Partners Report for each individual request via recharge is €2.10 + VAT.