Risk

The Risk API provides access to data and reports to verify the reliability of private and legal entities. You can have access, depending on the type of endpoint, from single data (e.g. telephone or negativity) up to reports with dozens of information and verified by dedicated professionals.

Reports can be requested in PDF or JSON format.

Each report has a different cost. All prices are available in the Pricing section.

The processing time for reports depends on the type:

• Report Persona Real Time: a few minutes
• Report Persona Top: 6-8 days
• Asset Report Person: 6-8 days
• Asset Report Top Person: 6-12 days
• Heirs Report: 6-8 days
• Company Report: 10 minutes
• Top Company Report: 6-8 days
• CRIF (Financial Risk Centre) Person - Company Registration Report: 20 days
• Risk RealTime (Anagrafica, Telefoni, Negatività): pochi secondi

The reports are asynchronous so we suggest setting up the callback at the request stage.

If the callback has not been set, the endpoint with the GET method specific to that endpoint must be used to check if a report is available for download. For example, for Report Asset Person a request must be made to GET /IT-patrimoniale-persona/{id}; the id is available in the response to the document request.

Yes, it is possible to customise all reports with the exception of the CRIF (Financial Risk Centre) Company Registration Reports (for Person and Company).

In particular, you can customise:

• Title
• Logo
• Description

Customisation can be indicated when requesting the report using either the following parameters: "logoPdf", "titlePdf", "textPdf".

If they are not indicated, the default values will be used.

For Person Reports (Report Person, Asset Person, Asset Person Top) the following data must be passed in the body of the request:

• First name (name)
• Surname
• TaxCode

Optional parameters for customising the report are: "logoPdf", "titlePdf", "textPdf".

For Company Reports (Company Report and Top Company Report) the following data must be passed in the body of the request:

• Company Name (companyName)
• Tax Code (taxCode)

VAT number (vatCode) and the values for customising the report are optional: "logoPdf", "titlePdf", "textPdf".

For Heir reports (with or without acceptance) the following data must be passed in the body of the request:

• First name (name)
• Surname (surname)
• TaxCode

Optional parameters for customising the report are: "logoPdf", "titlePdf", "textPdf".

To request the CRIF (Financial Risk Centre) Company Registration Report for a Person you must send in the body of the request:

• Name and Surname
• Date and place of birth
• Place of residence
• Tax code
• Document type and data
• Copy of valid identity document in PDF
• Copy of valid health card in PDF format

To request the CRIF (Financial Risk Centre) Company Registration Report for a Company you must send in the body of the request:

• Company Name
• Legal form
• Tax Code
• VAT number
• PEC (Certified email address)
• Head office
• Name, date and place of birth and residence of valid legal representative in PDF
• Copy of valid PDF document and health card of legal representative
• Chamber of Commerce certificate updated not later than 6 months

In the Usage section, at the API level, you can monitor your free and subscription or top-up requests. They are available both graphically (period month and year) and with a textual summary.

Data and reports are taken from official and certified sources and public databases such as Registry Office, Chamber of Commerce, Revenue Agency, CRIF (Financial Risk Centre), Experian.