HomeProductsActive Partners Report

Active Partners Report

€0.001 + VAT

Obtain data on individual company members, such as name and residence, starting from the tax code, VAT number, or company ID.

Delivery

In real time

available for
  • it

The Active Members Company service allows you to obtain, starting from a single parameter (tax code, VAT number, or ID) of the company:

  • company information such as CCIAA, REA, legal form, ATECO code, business status, registered office, share capital
  • information about individual members such as name, tax code, place and date of birth, residence, shares

On Openapi, it is possible to request the Members Reports through 2 different APIs:

REQUEST ACTIVE MEMBERS REPORT WITH COMPANY REGISTRY REPORTS API

The advantage of using the Company Registry Reports API is that it allows direct requests. No additional requests are required to obtain hashes or parameters.

Request report

POST /active-members

With a single request, for example, to the endpoint POST /active-members, it will be possible to complete the report request, starting from one of the following data:

  • VAT Number / Company Tax Code
  • Company ID

REQUEST EXAMPLE

POST /active-members

In our case, we chose to pass the tax code in the request body

{
  "cf_piva_id":"12485671007",
  "callback": {
    "url":"https://www.your_url.it/callback",
    "method":"POST",
    "field":"data"
  }
}

The company ID can be obtained through the two commercial search services starting from the name (or some criteria such as ATECO code and turnover) or from the VAT number / tax code. You can also choose to set a callback to be updated when the document is available without having to call the endpoint GET/active-members/{id} to check its status.

RESPONSE EXAMPLE

POST /active-members

The response returns the status, the request timestamp, any set callback URL, and the request ID that will be needed for future requests and to obtain the data.

{
    "data": {
      "cf_piva_id": "12485671007",
      "type": "active-members",
      "request_status": "In progress",
      "timestamp_creation": 1703852089,
      "timestamp_last_update": 1703852236,
      "attachments": [
      "65671d1c207bbf56a50aa122.pdf"
      ],
      "callback": {
        "url": "https://www.your_url.it/callback",
        "method": "POST",
        "field": "data",
        "data": {}
      },
      "owner": "gcloud-tests@openapi.it",
      "id": "658eb839e5a329399f6bffb2"
    },
    "success": true,
    "message": "",
    "error":  
  }  

Check the status of the request

GET/active-members/{id}

You can check the status of an Active Members request via the endpoint GET/active-members/{id}. As previously suggested, we recommend setting the callback during the request phase to be updated when the document is available and can be downloaded.

REQUEST EXAMPLE

GET/active-members/{id}

The id is the one obtained and available in the response after the request to the endpoint POST /active-members:

https://visurecamerali.openapi.it/active-members/{id}/attachments

RESPONSE EXAMPLE

GET/active-members/{id}

The response includes all the previously mentioned data about the company and members, with the timestamp of the request and the last update, and any callback URL.

{
    "data": {
      "cf_piva_id": "12485671007",
      "type": "active-members",
      "request_status": "In progress",
      "timestamp_creation": 1703852089,
      "timestamp_last_update": 1703852236,
      "attachments": [
      "65671d1c207bbf56a50aa122.pdf"
      "cf_piva_id": "12485671007",
      "json_members": {
        "company": {
          "cciaa": "RM",
          "rea_number": "1378273",
          "name": "OPENAPI S.R.L.",
          "tax_code": "12485671007",
          "vat_number": "12485671007",
          "legal_nature_code": "SR",
          "legal_nature": "LIMITED LIABILITY COMPANY",
          "address": {
            "toponym_code": "VLE",
            "toponym": "VIALE",
            "name": "F TOMMASO MARINETTI",
            "number": "221",
            "postal_code": "00143",
            "municipality_code": "RM091",
            "istat_municipality_code": "H501",
            "municipality": "ROME",
            "fraction": null,
            "province": "RM",
            "country": "ITALY"
          },
          "ateco_code": [
            {
              "ateco_code": "6201",
              "ateco_description": "Production of software not related to publishing"
            }
          ],
          "activity_status": "ACTIVE",
          "activity_start_date": "2013-10-20",
          "activity_end_date": null,
          "share_capital": null,
          "presence_of_undetermined_rights": null,
          "undetermined_rights_share": null,
          "shares": []
        },
        "members": [
          {
            "name": "SCXXXXX XXXA",
            "natural_person": true,
            "tax_code": "SCRXXXXXH501H",
            "birth_date": "1973-10-02",
            "birth_province": "RM",
            "birth_municipality": "ROME",
            "birth_municipality_code": "RM091",
            "istat_birth_municipality_code": "H501",
            "birth_country": "ITALY",
            "gender": "MALE",
            "shares": [
              {
                "deed_date": "2021-09-10",
                "deposit_date": "2021-09-15",
                "protocol_date": "2021-09-15",
                "right_type_code": "01",
                "right_type_description": "OWNERSHIP",
                "real_right": true,
                "number_of_shares_owned": 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"
          },
          {
            "name": "XXXXIA SXXN",
            "natural_person": true,
            "tax_code": "DLCXXXXX9Z114J",
            "birth_date": "1977-11-29",
            "birth_province": null,
            "birth_municipality": null,
            "birth_municipality_code": null,
            "istat_birth_municipality_code": "Z114",
            "birth_country": "UNITED KINGDOM",
            "gender": "MALE",
            "shares": [
              {
                "deed_date": "2021-09-10",
                "deposit_date": "2021-09-15",
                "protocol_date": "2021-09-15",
                "right_type_code": "01",
                "right_type_description": "OWNERSHIP",
                "real_right": true,
                "number_of_shares_owned": null,
                "share_type_code": null,
                "share_type_description": null,
                "share_value": 10000,
                "ownership_percentage": 20,
                "undetermined_share": false
              }
            ],
            "other_companies_with_shares": null,
            "surname": "XXXXIA",
            "first_name": "SXXN"
          },
          {
            "name": "DXXXS SXXXE",
            "natural_person": true,
            "tax_code": "DSNXXXXX117F",
            "birth_date": "1980-08-11",
            "birth_province": "TR",
            "birth_municipality": "TERNI",
            "birth_municipality_code": "TR032",
            "istat_birth_municipality_code": "L117",
            "birth_country": "ITALY",
            "gender": "MALE",
            "shares": [
              {
                "deed_date": "2021-09-10",
                "deposit_date": "2021-09-15",
                "protocol_date": "2021-09-15",
                "right_type_code": "01",
                "right_type_description": "OWNERSHIP",
                "real_right": true,
                "number_of_shares_owned": null,
                "share_type_code": null,
                "share_type_description": null,
                "share_value": 10000,
                "ownership_percentage": 20,
                "undetermined_share": false
              }
            ],
            "other_companies_with_shares": null,
            "surname": "DXXXS",
            "first_name": "SXXXE"
          }
        ]
      },
      "type": "active-members",
      "request_status": "Fulfilled",
      "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": "gcloud-tests@openapi.it",
      "id": "658eb839e5a329399f6bffb2"
    }, 
}

Download Active Members Report

GET/active-members/{id}/attachments

It is also possible to obtain all the data in XML and PDF formats via the endpoint GET/active-members/{id}/attachments

REQUEST EXAMPLE

GET/active-members/{id}/attachments

The request should be made with the id obtained in the response from the endpoint POST /active-members.

https://visurecamerali.openapi.it/active-members/5f2829ce065afc21cc60ad0e/attachments/

RESPONSE EXAMPLE

GET/active-members/{id}/attachments

The response will indicate the file name, size, and file.

{ "data":
    {
    "name": "6564a673ccfa313352066377.zip",
    "size": 1728,
    "file": "UEsDBBQAAAAlNnVTBs6lJ1vIIAJthCQAcABwANjI2OTFjNGY5N2UwOTQ0NzU0MDI3ADU/HOUbc+WLQqnnTtt27Zt27Zt25k7bdu2bdvcadv5fnXOqapz655qt9p93x/vW62tFjHnGmv2HiMiZvQxY7RJIi8sSsNAywxFcnA4uwjFgE+Pb2doCcXNTSdqYe1s4kgnam3gbCJsYmRnbEInbWJr5"
      }

REQUEST REPORT ACTIVE MEMBERS WITH VISENGINE API

GET/visure

To request reports with Visengine, you first need to identify the hash that uniquely identifies each document or case.

https://visengine2.altravia.com/visure/

This can be done through the GET/visure endpoint, which requires no parameters and will return the complete list of documents and cases available via Visengine and their hashes.

Verify Data and Report Request Costs

GET/visure/{hash_visura}

If you want to verify the information, required documents, and costs of the report, you need to make a request via the GET/visure/{hash_visura} endpoint and pass the hash of the certificate previously obtained.

REQUEST EXAMPLE

GET/visure/{hash_visura}

To check fields and costs to complete the request, use the hash obtained from the previous request.

https://visengine2.altravia.com/visure/fab482bf67a418f00d596b7296750a9a

RESPONSE EXAMPLE

GET/visure/{hash_visura}

The response will provide all the necessary information to complete the request, such as required fields.

{
  "data": {
    "nome_visura": "Active Members Company",
    "ricerca": false,
    "nome_categoria": "Chamber",
    "json_struttura": {
      "campi": {
        "$0": {
          "nome": "Tax Code",
          "tipo": "tax_code",
          "null": false,
          "istruzioni": "Enter the Tax Code of the Company",
          "ordine": "1"
        }
      },
      "validazione": "$0  ",
      "istruzioni": "",
      "istruzioni_ricerca": ""
    },
    "hash_visura": "70a1b5d29d8efaae6ef9616841fd6f72",
    "prezzo_visura": 2.1,
    "prezzo_ricerca": 0,
    "sincrona": false,
    "opzioni": null,
    "fornitori": []
  },
  "success": true,
  "message": "",
  "error": null
}

The validation section indicates the mandatory data required to successfully complete the request.

Request Report

POST /request

To request the report, the tax code of the subject is provided.

REQUEST EXAMPLE

POST /request

{
    "hash_visura": "70a1b5d29d8efaae6ef9616841fd6f72",
    "json_visura": {
      "$1": 12485671007
      }
  }

RESPONSE EXAMPLE

POST /request

The response returns various pieces of information, including the status, the callback (if set), and the request ID, which will be needed later to download the document.

{ "data":
    {
      "_id": "5f2829ce065afc21cc60ad0e",
    "state": 1,
    "hash_visura": "70a1b5d29d8efaae6ef9616841fd6f72",
    "name": "Active Members",
    "search": false,
    "search_id": null,
    "report_price": 2.3,
    "search_price": 0,
    "search_index": null,
    "request_status": "In processing",
    "email_target": null,
    "attachments": [],
    "timestamp_creation": 1596467662,
    "timestamp_last_update": 1596467663,
    "timestamp_statuses": {
      "in_search": 1596467663,
      "in_processing": 1596467663
    },
    "callback_data": false,
    "options": null,
    "owner": "tester@openapi.com",
    "synchronous": false,
    "searches": [
      {
        "search_id": "5f2829ce065afc21cc60ad0e_0",
        "search_status": "Search completed",
        "search_json": "{\"$1\":\"12485671007\"}",
        "mapped_json": {
          "NRea": "1378273",
          "Cciaa": "RM"
        },
        "result_json": null
      }
    ],
    "result": {
      "code": "0",
      "info": "OK"
    }

Download Report

GET/document/{_id}

When the request status is "completed", it is possible to download the data in JSON, PDF, and XML formats using the GET/document/{_id} method.

REQUEST EXAMPLE

GET/document/{_id}

This is an example of a request made using the previously obtained ID.

https://visengine2.altravia.com/visure/documento/5f2829ce065afc21cc60ad0e

RESPONSE EXAMPLE

GET/document/{_id}

The response will include 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.

Sign Up

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!

Frequently Asked Questions

The Current Company Representatives Report provides, through API, detailed information on the active representatives in a specific company. It includes data such as role, name, tax code, and duration of positions held. This report is essential for governance analysis, responsibility verification, and monitoring key positions. It offers a clear and updated view of influential representatives, supporting informed decisions for professionals and businesses.

What is the Current Company Representatives Report?

The Current Company Representatives Report allows you to obtain a series of detailed information by entering the individual's tax code. The information includes:

  • Personal data: first name, last name, tax code, date and place of birth, residence.
  • Company data: information on the Chamber of Commerce (CCIAA), REA number, legal nature, ATECO code, and company's activity status.
  • Role data: role code, description, start date, and duration of the held position.

This service provides a comprehensive and accurate overview of an individual's active corporate roles, facilitating necessary verifications and analyses.

What information does the Current Company Representatives Report include?

The Company Current Partners Report is designed for various professionals and organizations that need detailed information on a company's corporate structure, including:

  • Companies that wish to understand the corporate structure of potential partners or competitors.
  • Investors who want to evaluate a company's shareholders before an investment.
  • Financial institutions to verify the reliability and composition of corporate ownership.
  • Legal and tax consultants to analyze corporate participation.
  • Recruitment agencies to evaluate active shareholders of a company.
Who is the Company Current Partners Report intended for?

The cost of the Current Company Representatives Report for each individual request via recharge is €2.10 + VAT.

What are the costs of the Current Company Representatives Report?

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. This variety of formats ensures flexibility and ease of use for all users.

In which formats are the information available?

Companies that wish to obtain information about active executives in another company.

Financial institutions to verify leadership and corporate management before granting credits.

Investors to assess the management team of a company they intend to invest in.

Legal and tax consultants to monitor the active managerial roles within a company.

Recruiters who need to evaluate the leadership roles of potential candidates.

Who is the Current Company Representatives Report intended for?

The information is provided via API in real time, ensuring immediate access to the requested data.

What are the service's response times?

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.

What is the Company Current Partners Report?

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:

  • Company data: Chamber of Commerce (CCIAA), REA number, legal nature, ATECO code, activity status, registered office, and share capital.
  • Shareholder information: name, tax code, place and date of birth, residence, and details on held shares.

On Openapi, you can request Shareholder Reports through two different APIs:

  • Company Reports
  • Visengine
What information does the Company Current Partners Report include?

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.

In which formats are the information available?

The cost of the Company Current Partners Report for each individual request via recharge is €2.10 + VAT.

What are the costs of the Company Current Partners Report?

The information is provided via API in real time, ensuring immediate access to the requested data.

What are the service's response times?