Live Video Identification - Italy

The API Video Identification 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.

Currently, Openapi offers 3 different video recognition services for Italy:

In all cases, the documents uploaded are verified through CRIMNET, the centralized platform of the Ministry of the Interior and the Ministry of Justice, which ensures there are no reports of theft, loss, or other issues.

The entire identification process is encoded by the Bank of Italy in the provisions related to Customer Due Diligence to combat money laundering and terrorist financing.

Live Video Identification

The third identification mode, known as Live, is the most used and allows individuals to complete the video recognition procedure independently, at any time of the day. The user is supported in real-time by an operator throughout the recognition procedure and the verification of data accuracy.

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

REQUEST EXAMPLE

POST /IT-live

The video recognition procedure is very flexible and can be structured according to the integrator's needs. The only mandatory field during the request is the applicant's email address.

At this stage, it is possible, but not mandatory, to also pass the following data:

These same details can also be obtained directly in the next step during the user identification process.

The API allows for customization of the user's experience while performing the video procedure. Specifically, you can customize:

During the request phase, you can also set the format of the documentation output. It could be:

All data is also available 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"
        }
      }

RESPONSE EXAMPLE

POST /IT-live

The response includes the following data:

{
      "data": {
        "id": "aaaaaaaa-1111-2222-dddd-123456789",
        "link": "https://sit-openapi.certid.it/aaaaaaaa-1111-2222-dddd-12345678",
        "message": "The link for the automated Video Identification service.",
        "status": "running",
        "owner": "[email protected]"
      },
      "success": true,
      "message": "",
      "error": null
    }

Once the link is obtained, it will be possible to send it to the user whose identification is required.

The integrator will find the most suitable solution for sending the link (for example via SMS - integrating the specific Openapi service - or via email or displaying it directly on screen).

The steps the user will follow after clicking the link are predefined and include the following:

The live procedure is subject to human verification according to Etsi guidelines.

The documents usable for identification are:

To check the status of a request, an API request must be made to the endpoint GET /IT-identity-verifications/{id}{type} (the id is the one obtained previously).

The response will contain both the link for that specific video recognition and the information on the status of the procedure (e.g., ‘ko’, ‘validation’, ‘running’), as well as the reason for the latter.

When the process has been completed successfully, it will be possible to access the process audit and time-stamping which legally attest to the date and time of execution.

Access to data

REQUEST EXAMPLE

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

In case of success (OK), it is then possible to access the data and resources for the next 30 days through the parameters:

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

RESPONSE EXAMPLE

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

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

At any time, 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.

Video recognition services are currently available for the identification of Italian citizens, regardless of their residence, provided they have one of the documents listed above and it is valid. In the event of a negative result during the process, it is possible to access information on the cause of the rejection, allowing for corrections or appropriate actions.

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