# Initiates a data intelligence workflow for identity verification

Starts a Data Intelligence process to collect and analyze personal data for the purpose of verifying a user's identity.  This may involve checks against official records, biometric data, and other sources to validate the identity in compliance with onboarding and regulatory requirements.

Endpoint: POST /dataHub
Version: 2.0.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `referenceId` (string)

  - `requestTypeId` (string, required)

  - `parameters` (object)

  - `parameters.firstName` (string)

  - `parameters.lastName` (string)

  - `parameters.phoneNumber` (string)

  - `parameters.email` (string)

  - `parameters.personalNumber` (string)

  - `parameters.gender` (string)

  - `parameters.birthDate` (string)

  - `parameters.nationality` (string)

  - `parameters.identityVerification` (object)

  - `parameters.identityVerification.documentDetails` (object)

  - `parameters.identityVerification.documentDetails.issuanceCountry` (string)
    Country where the document was issued, in ISO 3166-1 alpha-2 format.

  - `parameters.identityVerification.documentDetails.issuanceAuthority` (string)
    Name of the authority that issued the document. Note: If issuanceCountry is "IT", this field is required only when type is "DrivingLicense". Optional otherwise. Current values:
  - 'PREFECTURE'
  - 'POLICE_HEADQUARTERS'
  - 'CIVIL_MOTORIZATION_AUTHORITY'
  - 'MINISTRY_OF_INFRASTRUCTURE_AND_TRANSPORT_CENTRAL_OPERATIONS_OFFICE'
  - 'ITALIAN_REPRESENTATION_ABROAD'
  - 'MINISTRY_OF_FOREIGN_AFFAIRS'

  - `parameters.identityVerification.documentDetails.type` (string)
    Type of the identity document. Can be one of:
- IdentityCard - Passport - DrivingLicense

  - `parameters.identityVerification.documentDetails.number` (string)
    Unique identifier or number of the document.

  - `parameters.identityVerification.documentDetails.issuedOn` (string)
    Date on which the document was issued (ISO 8601 format).

  - `parameters.identityVerification.documentDetails.expiryDate` (string)
    Date on which the document expires (ISO 8601 format).
Note: If issuanceCountry is "IT", this field is required only when type is "DrivingLicense". Optional otherwise.

  - `parameters.digitalFootprint` (object)

  - `parameters.digitalFootprint.ipAddress` (string)

  - `parameters.legalEntity` (object)

  - `parameters.legalEntity.legalEntityName` (string)

  - `parameters.legalEntity.legalEntityId` (string)

## Response 200 fields (application/json):

  - `id` (string)