Current Roles Report on Individuals - Italy
€2.10 + VAT
Obtain real-time information about roles, positions, and qualifications held in companies by individuals or legal entities via API.
The Current Roles Report on Individuals Service allows you to obtain, starting from the tax code of the subject:
- information about the person such as name, surname, tax code, date and place of birth, residence
- information about the company such as Chamber of Commerce number, REA, legal nature, ATECO code, and activity status
- information on positions such as code, description, start date, duration
Data is available in real-time through the Openapi Visengine API and can be downloaded in PDF, JSON, or XML format.
Here are the steps to obtain the report.
REQUEST ACTIVE POSITIONS REPORT WITH VISENGINE API
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 can be done through the endpoint GET/visure which does not require parameters and will return the complete list of documents and practices available through Visengine and their hashes.
VERIFY DATA AND REPORT REQUEST COSTS
GET/visure/{hash_visura}
If you want to check the information, necessary documents, and costs of the report, you need to make a request through the endpoint GET/visure/{hash_visura} and pass the hash of the certificate previously obtained.
REQUEST EXAMPLE
GET/visure/{hash_visura}
To verify fields and costs to complete the request, you need to use the hash obtained in the previous request.
https://visengine2.altravia.com/visure/fab482bf67a418f00d596b7296750a9aEXAMPLE RESPONSE
GET/visure/{hash_visura}
The response will include all the necessary information to complete the request, such as required fields.
{
"data": {
"hash_visura": "f3a0979f15915b337aafabcd89c5ee70",
"json_struttura": {
"campi": {
"$0": {
"nome": "Tax Code",
"tipo": "personal_tax_code",
"null": false,
"istruzioni": "Enter the personal tax code",
"ordine": "1"
}
},
"validazione": "$0 ",
"istruzioni": "",
"istruzioni_ricerca": ""
},
"nome_visura": "Cameral",
"nome_visura": "Active Positions Person",
"ricerca": false,
"nome_categoria": "Cameral",
"prezzo_visura": 2.1,
"prezzo_ricerca": 0,
"sincrona": false,
"opzioni": null,
"fornitori": []
},
"success": true,
"message": "",
"error": null
}Validation indicates the mandatory data needed to complete the request successfully.
REQUEST REPORT
POST /request
To request the report, the tax code of the subject is passed.
EXAMPLE REQUEST
POST /request
{
"hash_visura": "f3a0979f15915b337aafabcd89c5ee70",
"json_visura": {
"$1": 12485671007
}
}EXAMPLE RESPONSE
POST /request
The response returns various pieces of information including the status, the callback (if set), and the request ID that will be needed later to download the document.
{ "data":
{
"_id": "5f2829ce065afc21cc60ad0e",
"state": 1,
"hash_visura": "f3a0979f15915b337aafabcd89c5ee70",
"nome": "Active Positions 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"
}DOWNLOAD REPORT
GET/document/{_id}
Once the request status is "completed," you can download the data in JSON, PDF, and XML formats using the method GET/document/{_id}
EXAMPLE REQUEST
GET/document/{_id}
This is an example of a request made using the previously obtained ID
https://visengine2.altravia.com/visure/document/5f2829ce065afc21cc60ad0e
EXAMPLE RESPONSE
GET/document/{_id}
The response will contain the name, size, and file.
{
data{
"name":"5f22f5b5065afc21cc60a27a.zip",
"size": "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 Current Positions Report service allows you to integrate, via API and in real time, the request for a document containing detailed information about a private individual and their active positions. Starting from the individual's tax code, it is possible to access data relating to the person, the company, and the positions they hold.
The service is part of Docuengine, the API that allows you to request over 128 official documents, services, reports, and assessment documents, with data coming from certified sources (e.g., Chamber of Commerce, INPS, and the Revenue Agency). Here are the main categories of documents available via API:
- Chamber of Commerce documents
- Land Registry documents
- Real Estate services
- Patronage services
With Docuengine, you can obtain:
- Official information and documents on companies such as financial statements, company dossiers, shareholder lists, and chamber of commerce certificates
- Official information and documents on individuals such as negative events, positions, and shares
- Official information and documents on properties and owners such as land registry records, mortgage reports, and floor plans
Additionally, it is possible to submit applications through CAF, for example for pensions, NASpI, ISEE, 730.
The service provides the following information:
- About the person: First name, last name, tax code, date and place of birth, residence.
- About the company: CCIAA, REA, legal nature, ATECO code, and activity status.
- About the positions: Code, description, start date, and duration of active positions.
The report can be downloaded in PDF format.
Yes, in addition to the Current Positions Person Report, the following reports dedicated to private individuals are also available on Openapi:
- Asset Report Person
- Top Asset Report Person
- Real Time Person Report
- Top Person Report
- Active Shares Person Report
The Current Positions Person Report is ideal for companies and professionals, financial institutions, consultants, and law firms that need to quickly and automatically integrate the service of requesting a document containing detailed information on the corporate positions of private individuals. This facilitates the verification of the status and business responsibilities of potential clients or business partners.
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 time limit 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 single request is €2.10
Carbon free energy for Our Cloud 
Low CO2
© 2024 Openapi SpA, a single-member company, under the direction and control of Open Holding Srl.
Viale Filippo Tommaso Marinetti 221 - 00143 Rome - Business Register: 1378273, Share Capital: €50,000.00, VAT Number: IT12485671007, Recipient Code: 'USAL8PV' - Certified Email: [email protected]
Openapi is certified in: Quality System - **UNI EN ISO 9001:2015** - Data Quality **ISO 25012:2014** - Security Management **ISO/IEC 27001:2022**
All prices are net of any VAT, stamp duty, registration fees, or other taxes that may be due. All logos listed on the portal are copyrighted and owned by their respective owners.
