Risk

  1. Home
  2. API Library
  3. Risk
All reports and data to verify the reliability of private and legal entities

With Risk you access various databases such as Internal Revenue Service, Registry Office CCIAA, CRIF, Experian

All the knowledge you need

Here you can find some advice to consider to approach this API. If you prefer, we provide code samples, OAS3 documentation, the ability to try the API live via the Swagger UI or import the entire collection into Postman. We also offer a Sandbox environment where you can experiment with all kinds of requests completely free of charge.

Useful tips to start with Risk

Get the token in the appropriate section before you start.

Use the the online tool or generate it via API. Set the expire date, a usefull name and now add a bunch of scopes to limit the possible actions your token can do.
Read more on oauth API Manage my tokens

Choose the service that best suits you

The Risk API is very extensive and covers all aspects of risk management.

We can group the offered services into:

Depending on the service you prefer, different endpoints are available described below.

Credit Score (Synchronous / Real-time)

Starting from the VAT number, you can obtain structured information on creditworthiness through its 3 endpoints:

  • /IT-creditscore-start
    • "risk_score" (from GREEN to DARK RED)
  • /IT-creditscore-advanced
    • "risk_score" (from GREEN to DARK RED)
    • "risk_score_description" (details of the risk score)
    • "rating" (from A1 positive to C3 negative)
    • "risk_severity" (from 1 "low risk" to 990 "high risk")
  • /IT-creditscore-top
    • "risk_score" (from GREEN to DARK RED)
    • "history.risk_score" (previous monthly assessments)
    • "risk_score_description" (details of the risk score)
    • "rating" (from A1 positive to C3 negative)
    • "history.public_rating" (previous monthly assessments)
    • "operational_credit_limit" (estimated credit limit €)
    • "history.operational_credit_limit" (previous monthly assessments)
    • "positions" (Evaluations, descriptions and trends of the company in terms of financial, asset and financial position in a summary)
    • "profiles" (Analysis of single indices of financial, asset and financial profiles in a summarized way)

Read more on Credit Score

Company (Asynchronous)

Reports available in the Company section:

Read more on Company
API docs by Redocly

Risk (1.0.0)

URL: https://openapi.it/en/support License: Apache 2.0 Terms of Service

Web service that allows you to obtain a crif search on a person or a company.

First time here? Generate a new access token

Persona

Crif certificate on the person

List of your requests about the person

This method shows you the list of your persona crif requests that belong to your account

Authorizations:
bearerAuth

Responses

Response Schema: application/json
Array of objects (Richieste)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-crif-persona");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Request for a crif search on a person

This method allows you to request a crif to search on a person. It is important to provide a copy of an identity document and a copy of a health card in pdf format.

Authorizations:
bearerAuth
Request Body schema: application/json
first_name
required
string

first name

last_name
required
string

last name

email
required
string <email>

email

birth_date
required
string <date>

birth date

gender
required
string
Enum: "M" "F"

gender

fiscal_code
required
string

fiscal code

birth_city
required
string

birth city

birth_province
required
string

birth province

birth_country
required
string

birth country

residence_address
required
string

residence address

residence_street_number
required
string

residence street number

residence_city
required
string

residence city

residence_postal_code
required
string

residence postal code

residence_province
required
string

residence province

residence_country
required
string

residence country

document_type
required
string
Enum: "IDENTITY_CARD" "DRIVING_LICENSE" "PASSPORT"

document type

document_number
required
string

document number

release_date
required
string <date>

document release date

expiration_date
required
string <date>

document expiration date

release_city
required
string

document release city

release_province
required
string

document release province

public_authority
required
string

public authority that issued the document

required
string or string

document file in pdf format

required
string or string

health insurance card file in pdf format

object (Callback)

Responses

Response Schema: application/json
object (RichiestaPersona)
success
boolean
message
string
error
integer

Callbacks

Request samples

Content type
application/json
{
  • "first_name": "mario",
  • "last_name": "rossi",
  • "email": "[email protected]",
  • "birth_date": "1990-04-28",
  • "gender": "m",
  • "fiscal_code": "mrrrss89d28l117d",
  • "birth_city": "terni",
  • "birth_province": "tr",
  • "birth_country": "italia",
  • "residence_address": "via rossini",
  • "residence_street_number": "2",
  • "residence_city": "terni",
  • "residence_postal_code": "05100",
  • "residence_province": "tr",
  • "residence_country": "italia",
  • "document_type": "IDENTITY_CARD",
  • "document_number": "IT567TRF",
  • "release_date": "2010-12-01",
  • "expiration_date": "2030-12-01",
  • "release_city": "terni",
  • "release_province": "tr",
  • "public_authority": "comune",
  • "document_file": "JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7/AFAAUgBPAEMAVQBSAEEpCi9DcmVhdG9yICj+/wB3AGsAaAB0AG0AbAB0AG8AcABkAGYAIAAwAC4AMQAyAC4ANikKL1Byb2R1Y2VyICj+/wBRAHQAIAA0AC4AOAAuADcpCi9DcmVhdGlvbkRhdGUgKEQ6MjAyMzA1MTExMjE5NTIrMDInMDAnKQo",
  • "health_insurance_card_file": "JVBERi0xLjMKMyAwIG9iago8PC9UeXBlIC9QYWdlCi9QYXJlbnQgMSAwIFIKL1Jlc291cmNlcyAyIDAgUgovQ29udGVudHMgNCAwIFI+PgplbmRvYmoKNCAwIG9iago8PC9GaWx0ZXIgL0ZsYXRlRGVjb2RlIC9MZW5ndGggMjg1NT4+CnN0cmVhbQp4nKVa2XLjuBV976+4b85UeWCCO3teAlOQGgkXNUl5qlzzoliyw5QsTiT1TFV/TT4tn5ILgJvctgg7L6bF7dxz9wvQhr99sogXwJ94sCwLFp9uK7iZU6A2/obqEXj1yfOJH0EQUGLZ8AyeExKv/72D8tO/QT/",
  • "callback": {}
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Callback payload samples

Callback
POST: {$request.body#/callback/url}
Content type
application/json
{
  • "data": {
    }
}

Specific request

This method shows you the specific persona crif request related to the id

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/json
object (RichiestaPersona)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-crif-persona/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Upload the delegation file

This method allows you to upload the delegation file. The delegation file must be completed and signed. You can download it via the method GET/IT-crif-persona/{id}/delega.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Request Body schema: application/json
signed_delegation_file
string <byte>

base64_encode(file content); only pdf files are allowed

Responses

Response Schema: application/json
object (RichiestaPersona)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "signed_delegation_file": "JVBERi0xLjMKMyAwIG9iago8PC9UeXBlIC9QYWdlCi9QYXJlbnQgMSAwIFIKL1Jlc291cmNlcyAyIDAgUgovQ29udGVudHMgNCAwIFI+PgplbmRvYmoKNCAwIG9iago8PC9GaWx0ZXIgL0ZsYXRlRGVjb2RlIC9MZW5ndGggMjg1NT4+CnN0cmVhbQp4nKVa2XLjuBV976+4b85UeWCCO3teAlOQGgkXNUl5qlzzoliyw5QsTiT1TFV/TT4tn5ILgJvctgg7L6bF7dxz9wvQhr99sogXwJ94sCwLFp9uK7iZU6A2/obqEXj1yfOJH0EQUGLZ8AyeExKv/72D8tO/QT"
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Download the delegation file

This method allows you to directly download the delegation file. Once compiled and signed it will be passed in the form of a base 64 encoded string using the PATCH/IT-crif-persona/{id} method.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/pdf
string <binary>

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-crif-persona/%7Bid%7D/delega");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "success": false,
  • "message": "Wrong id",
  • "error": 301,
  • "data": null
}

List of your requests about the person

This method shows you the list of your patrimoniale-persona requests that belong to your account

Authorizations:
bearerAuth

Responses

Response Schema: application/json
object
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-patrimoniale-persona");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Specific request

This method shows you the specific persona patrimoniale-persona request related to the id

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-patrimoniale-persona/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "string",
  • "error": 0
}

This method allows you to directly download the pdf file with the required data.

Download the pdf file after it is ready. In the test you can simulate the creation of the pdf using "url/id?callback" and after that you can download it.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/pdf
string <binary>

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-patrimoniale-persona/%7Bid%7D/download");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/pdf
6477280f496e98e849017aa7.pdf

Request for a patrimoniale search on a person

This method allows you to request a patrimoniale-persona to search on a person. You can customize your report with titlePdf, logoPdf, textPdf otherewise the default values would be used

Authorizations:
bearerAuth
Request Body schema: application/json
name
required
string

first name

surname
required
string

last name

taxCode
required
string

taxCode / italian cf (codice fiscale)

object (Callback)
textPdf
string

description in cover footer pdf

titlePdf
string

Title cover pdf

logoPdf
string

URL for personal cover logo

note
string

first name

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

List of your requests about the person

This method shows you the list of your patrimoniale-persona requests that belong to your account

Authorizations:
bearerAuth

Responses

Response Schema: application/json
object
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-patrimoniale-persona-top");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Specific request

This method shows you the specific persona patrimoniale-persona request related to the id

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-patrimoniale-persona-top/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "string",
  • "error": 0
}

This method allows you to directly download the pdf file with the required data.

Download the pdf file after it is ready. In the test you can simulate the creation of the pdf using "url/id?callback" and after that you can download it.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/pdf
string <binary>

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-patrimoniale-persona-top/%7Bid%7D/download");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/pdf
6477280f496e98e849017aa7.pdf

Request for a patrimoniale search on a person

This method allows you to request a patrimoniale-top to search on a person. You can customize your report with titlePdf, logoPdf, textPdf otherewise the default values would be used

Authorizations:
bearerAuth
Request Body schema: application/json
name
required
string

first name

surname
required
string

last name

taxCode
required
string

taxCode / italian cf (codice fiscale)

object (Callback)
textPdf
string

description in cover footer pdf

titlePdf
string

Title cover pdf

logoPdf
string

URL for personal cover logo

note
string

first name

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

List of your requests about the person

This method shows you the list of your patrimoniale-persona requests that belong to your account

Authorizations:
bearerAuth

Responses

Response Schema: application/json
object
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-patrimoniale-persona-top-supervisionato");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Specific request

This method shows you the specific persona patrimoniale-persona request related to the id

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-patrimoniale-persona-top-supervisionato/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "string",
  • "error": 0
}

This method allows you to directly download the pdf file with the required data.

Download the pdf file after it is ready. In the test you can simulate the creation of the pdf using "url/id?callback" and after that you can download it.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/pdf
string <binary>

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-patrimoniale-persona-top-supervisionato/%7Bid%7D/download");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/pdf
6477280f496e98e849017aa7.pdf

Request for a patrimoniale search on a person

This method allows you to request a patrimoniale-top-supervisionato to search on a person. You can customize your report with titlePdf, logoPdf, textPdf otherewise the default values would be used

Authorizations:
bearerAuth
Request Body schema: application/json
name
required
string

first name

surname
required
string

last name

taxCode
required
string

taxCode / italian cf (codice fiscale)

object (Callback)
textPdf
string

description in cover footer pdf

titlePdf
string

Title cover pdf

logoPdf
string

URL for personal cover logo

note
string

first name

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

List of your requests about the person

This method shows you the list of your report-persona-top requests that belong to your account

Authorizations:
bearerAuth

Responses

Response Schema: application/json
object
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-report-persona-top");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Specific request

This method shows you the specific persona report-persona-top request related to the id

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-report-persona-top/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "string",
  • "error": 0
}

This method allows you to directly download the pdf file with the required data.

Download the pdf file after it is ready. In the test you can simulate the creation of the pdf using "url/id?callback" and after that you can download it.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/pdf
string <binary>

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-report-persona-top/%7Bid%7D/download");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/pdf
6477280f496e98e849017aa7.pdf

Request for a patrimoniale search on a person

This method allows you to request a report-persona-top to search on a person. You can customize your report with titlePdf, logoPdf, textPdf otherewise the default values would be used

Authorizations:
bearerAuth
Request Body schema: application/json
name
required
string

first name

surname
required
string

last name

taxCode
required
string

taxCode / italian cf (codice fiscale)

object (Callback)
textPdf
string

description in cover footer pdf

titlePdf
string

Title cover pdf

logoPdf
string

URL for personal cover logo

note
string

first name

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

List of your requests about the person

This method shows you the list of your report-persona requests that belong to your account

Authorizations:
bearerAuth

Responses

Response Schema: application/json
object
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-report-persona");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Specific request

This method shows you the specific report-persona request related to the id

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-report-persona/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "string",
  • "error": 0
}

This method allows you to directly download the pdf file with the required data.

Download the pdf file after it is ready. In the test you can simulate the creation of the pdf using "url/id?callback" and after that you can download it.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/pdf
string <binary>

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-report-persona/%7Bid%7D/download");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/pdf
6477280f496e98e849017aa7.pdf

Request for a report-persona search on a person

This method allows you to request a report-persona to search on a person. You can customize your report with titlePdf, logoPdf, textPdf otherewise the default values would be used

Authorizations:
bearerAuth
Request Body schema: application/json
name
required
string

first name

surname
required
string

last name

taxCode
required
string

taxCode / italian cf (codice fiscale)

object (Callback)
textPdf
string

description in cover footer pdf

titlePdf
string

Title cover pdf

logoPdf
string

URL for personal cover logo

note
string

first name

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

List of your requests about the person

This method shows you the list of your eredi-con-accettazione requests that belong to your account

Authorizations:
bearerAuth

Responses

Response Schema: application/json
object
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-eredi-con-accettazione");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Specific request

This method shows you the specific eredi-con-accettazione request related to the id

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-eredi-con-accettazione/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "string",
  • "error": 0
}

This method allows you to directly download the pdf file with the required data.

Download the pdf file after it is ready. In the test you can simulate the creation of the pdf using "url/id?callback" and after that you can download it.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/pdf
string <binary>

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-eredi-con-accettazione/%7Bid%7D/download");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/pdf
6477280f496e98e849017aa7.pdf

Request for a eredi-con-accettazione to search on a person

This method allows you to request a report-persona to search on a person. You can customize your report with titlePdf, logoPdf, textPdf otherewise the default values would be used

Authorizations:
bearerAuth
Request Body schema: application/json
name
required
string

first name

surname
required
string

last name

taxCode
required
string

taxCode / italian cf (codice fiscale)

object (Callback)
textPdf
string

description in cover footer pdf

titlePdf
string

Title cover pdf

logoPdf
string

URL for personal cover logo

note
string

first name

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

List of your requests about the person

This method shows you the list of your eredi-senza-accettazione requests that belong to your account

Authorizations:
bearerAuth

Responses

Response Schema: application/json
object
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-eredi-senza-accettazione");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Specific request

This method shows you the specific eredi-senza-accettazione request related to the id

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-eredi-senza-accettazione/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "string",
  • "error": 0
}

This method allows you to directly download the pdf file with the required data.

Download the pdf file after it is ready. In the test you can simulate the creation of the pdf using "url/id?callback" and after that you can download it.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/pdf
string <binary>

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-eredi-senza-accettazione/%7Bid%7D/download");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/pdf
6477280f496e98e849017aa7.pdf

Request for a eredi-senza-accettazione to search on a person

This method allows you to request a report-persona to search on a person. You can customize your report with titlePdf, logoPdf, textPdf otherewise the default values would be used

Authorizations:
bearerAuth
Request Body schema: application/json
name
required
string

first name

surname
required
string

last name

taxCode
required
string

taxCode / italian cf (codice fiscale)

object (Callback)
textPdf
string

description in cover footer pdf

titlePdf
string

Title cover pdf

logoPdf
string

URL for personal cover logo

note
string

first name

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Azienda

Crif search on the company

List of your requests about the company

This method shows you the list of your report-azienda requests that belong to your account

Authorizations:
bearerAuth

Responses

Response Schema: application/json
object
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-report-azienda");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Specific request

This method shows you the specific report-azienda request related to the id

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/json
object (RichiestaAziendaEuData)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-report-azienda/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "string",
  • "error": 0
}

This method allows you to directly download the pdf file with the required data.

Download the pdf file after it is ready. In the test you can simulate the creation of the pdf using "url/id?callback" and after that you can download it.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/pdf
string <binary>

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-report-azienda/%7Bid%7D/download");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/pdf
6477280f496e98e849017aa7.pdf

Request for a report-azienda to search on a person

This method allows you to request a report-azienda to search on a company. You can customize your report with titlePdf, logoPdf, textPdf otherewise the default values would be used

Authorizations:
bearerAuth
Request Body schema: application/json
companyName
required
string

company's name

taxCode
required
string

taxCode / italian cf (codice fiscale)

vatCode
string
note
string
object (Callback)
textPdf
string

description in cover footer pdf

titlePdf
string

Title cover pdf

logoPdf
string

URL for personal cover logo

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

List of your requests about the company

This method shows you the list of your report-azienda-top requests that belong to your account

Authorizations:
bearerAuth

Responses

Response Schema: application/json
object
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-report-azienda-top");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Specific request

This method shows you the specific report-azienda-top request related to the id

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/json
object (RichiestaAziendaEuData)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-report-azienda-top/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "string",
  • "error": 0
}

This method allows you to directly download the pdf file with the required data.

Download the pdf file after it is ready. In the test you can simulate the creation of the pdf using "url/id?callback" and after that you can download it.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/pdf
string <binary>

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-report-azienda-top/%7Bid%7D/download");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/pdf
6477280f496e98e849017aa7.pdf

Request for a report-azienda-top to search on a person

This method allows you to request a report-azienda to search on a company. You can customize your report with titlePdf, logoPdf, textPdf otherewise the default values would be used

Authorizations:
bearerAuth
Request Body schema: application/json
companyName
required
string

company's name

taxCode
required
string

taxCode / italian cf (codice fiscale)

vatCode
string
note
string
object (Callback)
textPdf
string

description in cover footer pdf

titlePdf
string

Title cover pdf

logoPdf
string

URL for personal cover logo

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

List of your requests about the company

This method shows you the list of your report-azienda-top-supervisionato requests that belong to your account

Authorizations:
bearerAuth

Responses

Response Schema: application/json
object
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-report-azienda-top-supervisionato");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Specific request

This method shows you the specific report-azienda-top-supervisionato request related to the id

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/json
object (RichiestaAziendaEuData)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-report-azienda-top-supervisionato/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "string",
  • "error": 0
}

This method allows you to directly download the pdf file with the required data.

Download the pdf file after it is ready. In the test you can simulate the creation of the pdf using "url/id?callback" and after that you can download it.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 6477280f496e98e849017aa7

Request id

Responses

Response Schema: application/pdf
string <binary>

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-report-azienda-top-supervisionato/%7Bid%7D/download");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/pdf
6477280f496e98e849017aa7.pdf

Request for a report-azienda-top-supervisionato to search on a person

This method allows you to request a report-azienda to search on a company. You can customize your report with titlePdf, logoPdf, textPdf otherewise the default values would be used

Authorizations:
bearerAuth
Request Body schema: application/json
companyName
required
string

company's name

taxCode
required
string

taxCode / italian cf (codice fiscale)

vatCode
string
note
string
object (Callback)
textPdf
string

description in cover footer pdf

titlePdf
string

Title cover pdf

logoPdf
string

URL for personal cover logo

Responses

Response Schema: application/json
object (RichiestaPersonaEuResponse)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

List of your requests about the company

This method shows you the list of your company crif requests that belong to your account

Authorizations:
bearerAuth

Responses

Response Schema: application/json
Array of objects (Richieste)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-crif-azienda");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Request for a crif search on a company

This method allows you to request a crif to search on a company. It is important to provide a copy of an identity document, a copy of a health card and a copy of a company registration report in pdf format.

Authorizations:
bearerAuth
Request Body schema: application/json
company_name
required
string

company name

company_legal_form
required
string

company legal form

company_tax_code
required
string

company tax code

company_vat_number
required
string

company vat number

company_certified_email
required
string <email>

company certified email

company_sdi
string

company sdi invoice code

company_address
required
string

company address

company_street_number
required
string

company street number

company_city
required
string

company city

company_postal_code
required
string

company postal code

company_province
required
string

company province

company_country
required
string

company country

first_name
required
string

legal representative first name

last_name
required
string

legal representative last name

birth_date
required
string <date>

legal representative birth date

gender
required
string
Enum: "M" "F"

legal representative gender

fiscal_code
required
string

legal representative fiscal code

birth_city
required
string

legal representative birth city

birth_province
required
string

legal representative birth province

birth_country
required
string

legal representative birth country

residence_address
required
string

legal representative residence address

residence_street_number
required
string

legal representative residence street number

residence_city
required
string

legal representative residence city

residence_postal_code
required
string

legal representative residence postal code

residence_province
required
string

legal representative residence province

residence_country
required
string

legal representative residence country

document_type
required
string
Enum: "IDENTITY_CARD" "DRIVING_LICENSE" "PASSPORT"

legal representative document type

document_number
required
string

legal representative document number

release_date
required
string <date>

legal representative document release date

expiration_date
required
string <date>

legal representative document expiration date

release_city
required
string

legal representative document release city

release_province
required
string

legal representative document release province

public_authority
required
string

ublic authority that issued the legal representative document

required
string or string

legal representative document file in pdf format

required
string or string

legal representative health insurance card file in pdf format

required
string or string

company registration report file in pdf format

object (Callback)

Responses

Response Schema: application/json
object (RichiestaAzienda)
success
boolean
message
string
error
integer

Callbacks

Request samples

Content type
application/json
{
  • "company_name": "openapi",
  • "company_legal_form": "sr",
  • "company_tax_code": "12485671007",
  • "company_vat_number": "12485671007",
  • "company_certified_email": "[email protected]",
  • "company_sdi": "",
  • "company_address": "via marinetti",
  • "company_street_number": "2",
  • "company_city": "roma",
  • "company_postal_code": "00128",
  • "company_province": "rm",
  • "company_country": "italia",
  • "first_name": "mario",
  • "last_name": "rossi",
  • "birth_date": "1990-04-28",
  • "gender": "m",
  • "fiscal_code": "mrrrss89d28l117d",
  • "birth_city": "terni",
  • "birth_province": "tr",
  • "birth_country": "italia",
  • "residence_address": "via rossini",
  • "residence_street_number": "2",
  • "residence_city": "terni",
  • "residence_postal_code": "05100",
  • "residence_province": "tr",
  • "residence_country": "italia",
  • "document_type": "DRIVING_LICENSE",
  • "document_number": "RT5677UI",
  • "release_date": "2001-12-31",
  • "expiration_date": "2030-12-31",
  • "release_city": "terni",
  • "release_province": "tr",
  • "public_authority": "mctc",
  • "document_file": "JVBERi0xLjMKMyAwIG9iago8PC9UeXBlIC9QYWdlCi9QYXJlbnQgMSAwIFIKL1Jlc291cmNlcyAyIDAgUgovQ29udGVudHMgNCAwIFI+PgplbmRvYmoKNCAwIG9iago8PC9GaWx0ZXIgL0ZsYXRlRGVjb2RlIC9MZW5ndGggMjg1NT4+CnN0cmVhbQp4nKVa2XLjuBV976+4b85UeWCCO3teAlOQGgkXNUl5qlzzoliyw5QsTiT1TFV/TT4tn5ILgJvctgg7L6bF7dxz9wvQhr",
  • "health_insurance_card_file": "JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7/AFAAUgBPAEMAVQBSAEEpCi9DcmVhdG9yICj+/wB3AGsAaAB0AG0AbAB0AG8AcABkAGYAIAAwAC4AMQAyAC4ANikKL1Byb2R1Y2VyICj+/wBRAHQAIAA0AC4AOAAuADcpCi9DcmVhdG",
  • "company_registration_report_file": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC9GaWx0ZXIvRmxhdGVEZWNvZGUvTGVuZ3RoIDI0MTkvTiAzPj5zdHJlYW0KpiGUlbuOUfkoHcIMHvf7eqrATV1bZpTTVMre2cUZvbDdUMl4+9NRagm9IquKs7XBFUeuqDxnLlMyPL83p4AD5+TOqvVD8kwtQSp5ezioMU/5vnfGDQSdDYcTp3QWvXxdPLREP89LnlSNLR/FrhaJ0J4amPSRm04uxKQ3",
  • "callback": {}
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Callback payload samples

Callback
POST: {$request.body#/callback/url}
Content type
application/json
{
  • "data": {
    }
}

Specific request

This method shows you the specific azienda crif request related to the id

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 64772d88496e98e849017aa8

Request id

Responses

Response Schema: application/json
object (RichiestaAzienda)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-crif-azienda/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Upload the delegation file

This method allows you to upload the delegation file. The delegation file must be completed and signed. You can download it via the method GET/IT-crif-azienda/{id}/delega.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 64772d88496e98e849017aa8

Request id

Request Body schema: application/json
signed_delegation_file
string <byte>

base64_encode(file content); only pdf files are allowed

Responses

Response Schema: application/json
object (RichiestaAzienda)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "signed_delegation_file": "JVBERi0xLjMKMyAwIG9iago8PC9UeXBlIC9QYWdlCi9QYXJlbnQgMSAwIFIKL1Jlc291cmNlcyAyIDAgUgovQ29udGVudHMgNCAwIFI+PgplbmRvYmoKNCAwIG9iago8PC9GaWx0ZXIgL0ZsYXRlRGVjb2RlIC9MZW5ndGggMjg1NT4+CnN0cmVhbQp4nKVa2XLjuBV976+4b85UeWCCO3teAlOQGgkXNUl5qlzzoliyw5QsTiT1TFV/TT4tn5ILgJvctgg7L6bF7dxz9wvQhr99sogXwJ94sCwLFp9uK7iZU6A2/obqEXj1yfOJH0EQUGLZ8AyeExKv/72D8tO/QT"
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Download the delegation file

This method allows you to directly download the delegation file. Once compiled and signed it will be passed in the form of a base 64 encoded string using the PATCH/IT-crif-azienda/{id} method.

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 64772d88496e98e849017aa8

Request id

Responses

Response Schema: application/pdf
string <binary>

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://risk.openapi.com/IT-crif-azienda/%7Bid%7D/delega");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "success": false,
  • "message": "Wrong id",
  • "error": 312,
  • "data": null
}
Web Service Revision: 2.0.0