Credit Scoring is the analysis of a series of financial and non-financial variables, helpful in determining the probability of insolvency or default on a loan.

Openapi, thanks to the adoption of artificial intelligence (AI), is able to offer an innovative API service that stands out for the efficiency and accuracy of the risk assessment process.

Currently, there are 3 endpoints available for the credit scoring service:

• Credit Score IT Start
• Credit Score IT Advanced
• Credit Score IT Top (under release)

1. CREDIT SCORE IT START

The Credit Score Start service allows access to a "traffic light" with 3 color scales. Additionally, based on the company's risk, a score and a merit description are provided.

The Credit Score Start service is identified by the endpoint https://risk.openapi.com/IT-creditscore-start/{vatCode_taxCode_or_id}

REQUEST EXAMPLE
(GET /IT-creditscore-start/{vatCode_taxCode_or_id})

The request parameter can be:

• VAT Number
• Tax Code
• Company ID

In the following request, we used the VAT Number: 12485671007

https://risk.openapi.com/IT-creditscore-start/12485671007

RESPONSE EXAMPLE
(GET /IT-creditscore-start/{vatCode_taxCode_or_id})

In the response, the following values are present:

• Company Name (organization_name)
• Request Date (requested_at)
• Risk Score (risk_score)
• Tax Code (tax)
• VAT Number (vat)
• Request ID (id)
• Company ID (company_id)
• Request Timestamp (time_stamp)

The risk score is identified by 3 colors:

• red
• yellow
• green

 In some cases, a grey colour may be returned to indicate ND cases such as terminated companies.

The data provided in the response is for illustrative purposes only.

{
  "data": {
    "company_id": "60d1bfc731177b0a092cdfc1",
    "organization_name": "XXXXXXXXXXX",
    "requested_at": "2024-03-26T10:53:56.299688Z",
    "risk_score": "VERDE",
    "tax": "12XXXXXXXX7",
    "vat": "12XXXXXXXX7",
    "time_stamp": 1622452306,    
    "id": "6602a94464cff7864a032475"
   },
  "success": true,
  "message": "",
  "error": null
  }

The Company ID (company_id), available in the response, is a useful parameter for making requests to Company API endpoints such as Start, Advanced, PEC.

2. CREDIT SCORE IT ADVANCED

The Credit Scoring Advanced service, in addition to the data present in the Start, includes the commercial credit limit and a comparison with the sector average.

The Commercial Credit Limit is calculated based on the company's legal form:

• For Capital Companies: it is based on the Rating and a series of other variables, such as the sector, size, assets attributable to the company, tangible assets, historical purchase data, etc.
• For Personal Companies and Sole Proprietorships: the algorithm is based on the dimensional estimate of the company, chamber and negativity databases, and a series of variables such as sector, economic categorization, date of establishment, number of employees, any debts, the company's real estate, corporate productivity, business transactions, etc.

REQUEST EXAMPLE
(GET /IT-creditscore-advanced/{vatCode_taxCode_or_id})

The request parameter can be:

• VAT Number
• Tax code
• Id company

In the following request, we used the VAT Number: 12485671007

https://risk.openapi.com/IT-creditscore-advanced/12485671007

RESPONSE EXAMPLE
(GET /IT-creditscore-advanced/{vatCode_taxCode_or_id})

In the response, the following values are present:

• Company Name (organization_name)
• Request Date (requested_at)
• Risk Score (risk_score)
• Description of Risk Score (risk_score_description)
• Maximum Credit Receivable from a Financial Institution (operational_credit_limit)
• Risk Severity (risk severity)
• Tax Code (tax)
• VAT Number (vat)
• Request ID (id)
• Company ID (company_id)
• Request Timestamp (time_stamp)

The risk score for this endpoint is identified by 7 colors:

• dark red
• bright red
• red
• yellow
• green
• light green
• dark green

Again, the grey colour indicating ND cases such as terminated enterprises may be returned.

The data provided in the response is for illustrative purposes only:

{
  "data": {
    "company_id": "60d1bfc731177b0a092cdfc1",    
    "operational_credit_limit": "82000",
    "organization_name": "XXXXXXXX",
    "rating": "A2",
    "requested_at": "2024-03-26T10:53:56.299688Z",
    "risk_score": "VERDE",
    "risk_score_description": "inferiore alla media",
    "risk_severity": "30",
    "tax": "12XXXXXXXX7",
    "vat": "12XXXXXXXX7",
    "time_stamp": 1622452306,    
    "id": "6602a94464cff7864a032475"
   },
  "success": true,
  "message": "",
  "error": null
  }