Automatic Video Identification - Italy

The Video Identification API allows the identity of users to be verified remotely, in an easy and fast manner while ensuring maximum security and full compliance with European regulations.

Integrating this API enables you to provide any type of service or product requiring user identity verification directly online, without needing to visit physical locations such as offices and studios. Additionally, it significantly reduces delivery times and the risk of fraud.

Openapi currently offers 3 different video recognition services for Italy:

All video recognition modes include verification of documents uploaded to CRIMNET, the centralized platform of the Ministry of the Interior and the Ministry of Justice, ensuring no reports of theft, loss, or other issues.

The entire identification process is encoded by the Bank of Italy in its provisions on Adequate Customer Verification to combat money laundering and terrorist financing.

Automatic Video Identification

The Automatic mode differs from the other two because it allows users to complete the entire video identification procedure independently at any time of the day.

The service is identified by the endpoint https://videoid.openapi.com/IT-automatic

EXAMPLE REQUEST

POST /IT-automatic

The video recognition process is extremely flexible and can be structured according to the integrator's needs. The only mandatory field in the request phase is the applicant's email address. It is possible, but not mandatory, to provide the following information at this stage:

The same data can also be directly obtained in the next step, i.e., during the user identification process.

The API allows customizing the user's experience while performing the video procedure; specifically, it will be possible to personalize:

At the request stage, you can also set the format of the documentation output. It can be:

It is also possible to obtain all data in JSON format.

{
    "callback": {
      "url": "https://mycallback.site/",
      "method": "POST",
      "field": "data",
      "headers": {
        "session_id": "oiwejdf89453urf945jfg"
      }
    },
    "mail": "[email protected]",
    "user": {
      "firstName": "Franco",
      "lastName": "Rossi",
      "gender": "M",
      "birthCountry": "Italy",
      "birthDate": "1977-11-06",
      "birthPlace": "Rome",
      "taxCode": "RSSMRA02D16A662G"
    },
    "healthCard": {
      "required": true,
      "checkExpire": true
    },
    "phoneNumber": {
      "required": true,
      "editable": true,
      "number": "3331234567"
    },
    "policy": {
      "url": "https://www.company.it/privacy-policy/"
    },
    "redirectUrls": {
      "success": "https://example.com/success",
      "failure": "https://example.com/failure"
    },
    "output": {
      "imagesAsPdf": false
    },
    "layout": {
      "title": "Video Identification",
      "logo": "https://www.website.it/logo.png",
      "favicon": "https://www.website.it/favicon.png",
      "backgroundColor": "#cecece",
      "textColor": "#000000",
      "footer": "Company Spa, VAT 11111111111"
    }
  }

EXAMPLE RESPONSE

POST /IT-automatic

The response includes the following data:

Once you have the link, you can send it to the user whose identification is needed.

In this case, it will be up to the integrator to find the most suitable way to send the link (e.g., via SMS - integrating the specific Openapi service - or via email or displaying it directly on the screen). The identification process, i.e., the steps the user will follow after clicking the link, is predefined and includes the following steps:

The automatic procedure is subject to human verification according to ETSI guidelines.

The documents that can be used for identification are:

To check the status of a request, you need to make an API request to the endpoint GET /IT-identity-verifications/{id} (the ID is the one obtained previously).

The response contains both the link to that specific video recognition and information about the status of the procedure (e.g., ‘ko’, ‘validation’, ‘running’), as well as the reason for it.

Once the procedure is completed successfully, you can access the process audit and timestamp, which legally certifies the date and time of execution.

Access to data

EXAMPLE REQUEST

GET /IT-identity-verifications/{id}{type}

In the case of a positive result (OK), you can then access the data and resources for the next 30 days using the parameters:

With the type parameter, you can specify the desired format for the data obtained during the video recognition process:

EXAMPLE RESPONSE

GET /IT-identity-verifications/{id}{type}

This is an example of a response if you select type /data:

You can also obtain the list of requests made with information on the status of the procedure, the reason for the status, and the request ID at any time.

Video recognition services are currently available for the identification of Italian citizens, regardless of their residence, provided they hold one of the previously indicated and valid documents.

In case of a negative outcome during the process, as mentioned above, you can access information about the reason for the rejection, allowing corrections or appropriate actions.

The video recognition procedure is particularly useful for digital onboarding activities, commercial operations, SIM activation, financial and banking operations (e.g., during the registration process at a banking institution).