Run with Postman
Documentation Powered 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) [ items ]
    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
      Default: "<string>"

      first name

      last_name
      required
      string
      Default: "<string>"

      last name

      email
      required
      string <email>
      Default: "<email>"

      email

      birth_date
      required
      string <date>
      Default: "<date>"

      birth date

      gender
      required
      string
      Default: "<string>"
      Enum: "M" "F"

      gender

      fiscal_code
      required
      string
      Default: "<string>"

      fiscal code

      birth_city
      required
      string
      Default: "<string>"

      birth city

      birth_province
      required
      string
      Default: "<string>"

      birth province

      birth_country
      required
      string
      Default: "<string>"

      birth country

      residence_address
      required
      string
      Default: "<string>"

      residence address

      residence_street_number
      required
      string
      Default: "<string>"

      residence street number

      residence_city
      required
      string
      Default: "<string>"

      residence city

      residence_postal_code
      required
      string
      Default: "<string>"

      residence postal code

      residence_province
      required
      string
      Default: "<string>"

      residence province

      residence_country
      required
      string
      Default: "<string>"

      residence country

      document_type
      required
      string
      Default: "<string>"
      Enum: "IDENTITY_CARD" "DRIVING_LICENSE" "PASSPORT"

      document type

      document_number
      required
      string
      Default: "<string>"

      document number

      release_date
      required
      string <date>
      Default: "<date>"

      document release date

      expiration_date
      required
      string <date>
      Default: "<date>"

      document expiration date

      release_city
      required
      string
      Default: "<string>"

      document release city

      release_province
      required
      string
      Default: "<string>"

      document release province

      public_authority
      required
      string
      Default: "<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
        Default: "<string>"
        Example: 6477280f496e98e849017aa7

        Request id

        Responses

        Response Schema: application/json