Company balance sheet

  • Openapi Delivery : 15 Minutes
  • Openapi starting from € 3,30 + vat

The company's balance sheet is delivered through service within 2 hours and can be requested for any capital company.

The Company balance sheet is an optical copy of the official financial statements presented and represents the balance sheet, financial and economic report of a company.

Esempio Company balance sheet

The service allows you to obtain a copy of the official financial statement deposited at the Chamber of Commerce. The financial statement will also be provided in XBRL format along with the minutes of the shareholders' meeting.

1) REQUEST A FINANCIAL STATEMENT (POST /bilancio-ottico)

One of the following is required to request a balance:

  • VAT Number / Tax Code of the Company/li>
  • Company ID

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

SAMPLE REQUEST POST /bilancio-ottico

This is an example of a budget request for a company with a VAT number 12485671007.

{
    "cf_piva_id": "12485671007"
    }

 

It is also possible to request the historical financial statement, meaning specifying the deposition year. In this case, it will be necessary to include the optional parameter 'anno_chiusura' in the request. In the absence of the parameter, the latest available financial statement will be returned

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

SAMPLE RESPONSE POST /bilancio-ottico

The response will include the closing year, the status of the request, whether a callback has been indicated, and especially the request ID necessary for downloading the document later.

{ "data": 
    {
     "cf_piva_id": "12485671007",
     "anno_chiusura": null,
     "tipo": "bilancio-ottico",
     "stato_richiesta": "In ricerca",
     "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. Therefore, in the response, the latest available financial statement will be returned

2) DOWNLOAD THE FINANCIAL STATEMENT(GET /bilancio-ottico/{id}/allegati)

Once the request has transitioned to the 'fulfilled' status, it is possible to download the document through the endpoint GET /bilancio-ottico/{id}/allegati

SAMPLE REQUEST POST /bilancio-ottico/{id}/allegati

The request must include the id we have previously referred to.

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


SAMPLE RESPONSE POST POST
/bilancio-ottico/{id}/allegati

The response will indicate name, size and file.

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

 

The content of the file is encoded in base64 and includes the XBRL version of the financial statement.

In the zip file provided in the response, the following documents will be available:

  • Income Statement
  • XBRL Balance Sheet
  • Minutes of the shareholders' meeting

3) VERIFY FINANCIAL STATEMENT REQUEST (GET /optical-balance/{id})

Once the request is made, it is possible to check the status of the financial statement at any time.

SAMPLE REQUEST GET /bilancio-ottico/{id}

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


SAMPLE RESPONSE POST GET /bilancio-ottico/{id}

The response will include:

  • The status of the request
  • The timestamp of the request
  • The timestamp of the request status update
  • The closing year
{ "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 Bilancio service, it is possible to understand the economic and financial status of a company, as well as verify its performance and stability in the last year or a specific year.

Our prices

Price list for single API calls

Subscribe and save

  • BILANCI AZIENDALI
  • 300 requests / year - 3,90€ per Bilancio Aziendale (pay annually) € 3,90 + vat
  • 1.200 requests / year - 3,60€ per Bilancio Aziendale (pay annually) € 3,60 + vat
  • 3.000 requests / year - 3,30€ per Bilancio Aziendale (pay annually) € 3,30 + vat