€2.10 + VAT
Get real-time information about the company shares held by an individual or entity via API.
With the Current Company Shares Report - service, it is possible to obtain in real-time, starting from the input of the subject's tax code:
The information is available in real-time through Openapi's Visengine API and can be downloaded in PDF, JSON, or XML format.
NOTE: This report only includes capital company shares.
Here are the steps to obtain the report.
GET/visure
To request reports with Visengine, you first need to identify the hash that uniquely identifies each document or practice.
https://visengine2.altravia.com/visure/
This is possible through the GET/visure endpoint, which does not require parameters and will return the complete list of documents and practices available through Visengine and regarding hash.
GET/visure/{hash_visura}
If you want to verify the information, required documents, and report costs, you need to make a request through the GET/visure/{hash_visura} endpoint and provide the hash of the previously obtained certificate.
GET/visure/{hash_visura}
To check fields and costs for completing the request, you need to use the hash obtained in the previous request.
https://visengine2.altravia.com/visure/367ff20236e836d81470f00ba1d9f703
GET/visure/{hash_visura}
The response will include all the necessary information to complete the request, such as mandatory fields.
{
"data": {
"nome_visura": "Active Quote Person",
"ricerca": false,
"nome_categoria": "Chamber",
"json_struttura": {
"campi": {
"$0": {
"nome": "Tax Code",
"tipo": "tax_code_person",
"null": false,
"istruzioni": "Enter the tax code of the individual",
}
},
"validazione": "$0 ",
"istruzioni": "",
"istruzioni_ricerca": ""
},
"hash_visura": "367ff20236e836d81470f00ba1d9f703",
"prezzo_visura": 2.1,
"prezzo_ricerca": 0,
"sincrona": false,
"opzioni": null,
"fornitori": []
},
"success": true,
"message": "",
"error": null
}
The validation shows the required data to complete the request successfully.
POST /request
To request the report, the tax code of the individual is passed.
POST /request
{
"hash_visura": "367ff20236e836d81470f00ba1d9f703",
"json_visura": {
"$1": 12485671007
}
}
POST /request
The response returns various information including the status, callback (if set), and the request ID that will be needed later to download the document.
{ "data":
{
"_id": "5f2829ce065afc21cc60ad0e",
"state": 1,
"hash_visura": "367ff20236e836d81470f00ba1d9f703",
"nome": "Active Quote Person ",
"ricerca": false,
"id_ricerca": null,
"prezzo_visura": 2.3,
"prezzo_ricerca": 0,
"indice_ricerca": null,
"stato_richiesta": "In progress",
"email_target": null,
"allegati": [],
"timestamp_creation": 1596467662,
"timestamp_last_update": 1596467663,
"timestamp_stati": {
"in_ricerca": 1596467663,
"in_erogazione": 1596467663
},
"callback_data": false,
"opzioni": null,
"owner": "[email protected]",
"sincrona": false,
"ricerche": [
{
"id_ricerca": "5f2829ce065afc21cc60ad0e_0",
"stato_ricerca": "Search completed",
"json_ricerca": "{\"$1\":\"12485671007\"}",
"json_mappato": {
"NRea": "1378273",
"Cciaa": "RM"
},
"json_risultato": null
}
],
"esito": {
"codice": "0",
"info": "OK"
}
GET/document/{_id}
When the request status is "completed," you can download the data in JSON, PDF, and XML formats via the method GET/document/{_id}
GET/document/{_id}
This is an example of a request made using the previously obtained ID.
https://visengine2.altravia.com/visure/document/5f2829ce065afc21cc60ad0e
GET/document/{_id}
The response will contain the name, size, and file.
{
data{
"nome":"5f22f5b5065afc21cc60a27a.zip",
"dimensione": "10206",
"file":"++6+47433njVP9ZcX1XNtWUsKrTya9FGhwiXgdp5j5OPh0FpaKWVpjP8CUEjFjYzYwYTI3YS5wZGZVVAUAAwhDKF91eAsAAQQhAAAABCEAAABQSwUGAAAAAAEAAQBiAAAAZicAAAAA"
},
"success": true,
"message": "",
"error": null
}
All formats (JSON, PDF, XML) will be available within a zip file.
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 Report on Current Shares of a Person is a report that provides information on the corporate shares owned by an individual based on their tax code. The service indicates the percentage of participation in various companies, the value of the shares held, and the type of holdings (e.g., ordinary or preferred shares). This tool is essential for financial analyses, investment evaluations, and corporate transparency checks. With quick and detailed access, professionals and businesses can make informed decisions based on accurate and up-to-date data.
The Report on Current Shares of a Person provides real-time, starting from the individual's tax code, a series of detailed information including:
The information can be obtained in real time via the Openapi Visengine API and downloaded in PDF, JSON, or XML formats.
Note: The report refers exclusively to shares in capital companies.
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 Report on Current Shares of a Person is designed for various professional figures and companies that need information on an individual's corporate holdings, including:
The information is provided via API in real time, ensuring immediate access to the requested data.
The cost of the Report on Current Shares of a Person for each individual request via recharge is €2.50 + VAT.
The report provides detailed information about:
The service is part of Risk, the API that allows access to numerous databases (e.g., Registry, Revenue Agency, CCIAA, CRIF, Experian) and over 15 reports and investigations on individuals, freelancers, and businesses with a single request. Here are some of the available information via API:
Yes, in addition to the Report on Current Shares of a Person, the following reports dedicated to private individuals are also available on Openapi:
The report can be downloaded in PDF format.
The Report on Current Shares of a Person via API is ideal for companies, financial institutions, legal consultants, and economic sector professionals who want to integrate a service via API to obtain in real time the document that monitors the participation shares of a private individual in capital companies. It is useful for those managing asset analyses, corporate verifications, or evaluations related to corporate participations and commercial operations.
Openapi manages the entire request process via API in full compliance with current privacy regulations, with data minimization and encryption practices. For more information on this, you can consult the Privacy documentation on our website.
The produced documents are deleted from Openapi's systems according to the timeframes visible in the Redemption Period (the deadline after which the document is deleted from our servers) in the privacy documentation. If necessary, the client can directly contact the authorized professional who provided the service, who is required to keep a copy according to regulations.
The service is provided in real time.
The cost per request is €2.10.