Company Balance Sheet - Italy

The service allows you to obtain a copy of the official balance sheet filed with the Chamber of Commerce. The balance sheet will also be provided in XBRL format and with the shareholders' meeting minutes.

It is possible to request the financial statement through the Chamber of Commerce Reports (Visure Camerali)  API, and the relevant endpoint is POST / visurecamerali.openapi.it/bilancio-ottico

REQUEST A BALANCE SHEET

POST /bilancio-ottico

To request a balance sheet, you need one of the following pieces of information:

The ID can be obtained through the two commercial search services based on the name (or some criteria such as ATECO code and turnover) or from the VAT number / tax code. In the response to requests from both endpoints, in addition to the ID and information such as the full name, the list of available certifications for that company is also provided.

REQUEST EXAMPLE

POST /bilancio-ottico

This is an example of a balance sheet request for the company with VAT number 12485671007.

{
    "cf_piva_id": "12485671007"
    }

You can also request the historical balance sheet, which means specifying the filing year. In this case, you need to include the optional parameter anno_chiusura in the request. If the parameter is not provided, the most recent available balance sheet will be returned.

During the request phase, we suggest setting up a callback to be notified when the document is available.

RESPONSE EXAMPLE

POST /bilancio-ottico

The response will include the closing year, the request status, whether a callback was specified, and most importantly, the request ID necessary for later downloading the document

{ "data": 
    {
     "cf_piva_id": "12485671007",
     "anno_chiusura": null,
     "tipo": "bilancio-ottico",
     "stato_richiesta": "In research",
     "timestamp_creation": 1701095027,
     "timestamp_last_update":1701095027,
     "allegati": [],
     "callback": false,
     "owner": "[email protected]",
     "id": "6564a6739b25c29e4f0dab34"
      },
        "message": "",
        "success": true,
        "error": null
      }

In this case, the closing year is null because it was not passed as a parameter, so the response will return the most recent available one.

DOWNLOAD THE BALANCE SHEET

GET /bilancio-ottico/{id}/allegati

Once the request has been marked as "completed", you can download the document through the endpoint GET /bilancio-ottico/{id}/allegati

EXAMPLE REQUEST

POST /bilancio-ottico/{id}/attachments

The request must include the ID that we referred to previously.

https://visurecamerali.openapi.it/6564a6739b25c29e4f0dab34/attachments

EXAMPLE RESPONSE

POST /bilancio-ottico/{id}/attachments

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

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

The content of the file is base64 encoded and also includes the XBRL version of the balance sheet.

The zip file in the response will contain the following documents:

CHECK BALANCE SHEET REQUEST

GET /bilancio-ottico/{id}

After making the request, you can check the status of the balance sheet at any time.

EXAMPLE REQUEST

GET /bilancio-ottico/{id}

https://visurecamerali.openapi.it/6564a6739b25c29e4f0dab34

EXAMPLE RESPONSE

GET /bilancio-ottico/{id}

The response will include:

{ "data": 
    {
     "cf_piva_id": "12485671007",
     "anno_chiusura": null,
     "tipo": "bilancio-ottico",
     "stato_richiesta": "Dati disponibili",
     "timestamp_creation": 1701095027,
     "timestamp_last_update":1701095027,
     "allegati": [],
     "callback": false,
     "owner": "[email protected]",
     "id": "6564a6739b25c29e4f0dab34"
      },
        "success": true,
        "message": "",
        "error": null
      }

With the Balance service, you can know the economic and financial status of a company and check its performance and stability in the last year or in a particular year.