DocumentationAPI Reference
General reference, eKYC Reference / eKYC Coverage

Italy

Italy eKYC verification matches submitted individual data against Italy's official civil register, credit, and telco records. See the eKYC API Reference for common response semantics that apply across all sources.

Available sources

Source API source string Description
Italy Civil Register + Credit + Telco IT_CIVIL_REG_CREDIT_TELCO Verifies submitted data against Italy's official civil register, consumer credit, and telco records.

Italy Civil Register + Credit + Telco

Request parameters

Parameter Required Description
source Mandatory Must be IT_CIVIL_REG_CREDIT_TELCO.
country Mandatory Must be IT.
firstName Mandatory First name of the individual. Must not contain digits.
surName Mandatory Last name of the individual. Must not contain digits.
phone Mandatory Italy phone number. See format note below.
street Optional Full street including house number.
city Optional City of the individual's address (for example, Milano).
postalCode Optional Italy postal code. See format note below.
dateOfBirth Optional Format: yyyy-mm-dd.

Sample request

{
    "plugins": ["kyc"], //required field
    "source": "IT_CIVIL_REG_CREDIT_TELCO", //required field
    "firstName": "Marco", //required field
    "surName": "Rossi", //required field
    "street": "Via Giuseppe Garibaldi 25",
    "city": "Milano",
    "postalCode": "20121",
    "country": "IT", //required field
    "dateOfBirth": "1991-08-02",
    "phone": "+390212345678" //required field
}

Response fields

Italy Civil Register + Credit + Telco anchors verification on individual name, address, and phone number. See the eKYC API Reference for common match field definitions and status values.

Field Statuses Description
firstNameMatch exact, fuzzy, nomatch Matches first name submitted against the value in the source of truth.
lastNameMatch exact, fuzzy, nomatch Matches last name submitted against the value in the source of truth.
fullNameMatch exact, fuzzy, nomatch Composite of firstNameMatch and lastNameMatch. exact if both match; nomatch if either does not match; otherwise fuzzy.
dobMatch exact, fuzzy, nomatch, nodata Matches date of birth submitted against the value in the source of truth.
streetMatch exact, fuzzy, nomatch, nodata Matches street submitted against the value in the source of truth.
cityMatch exact, fuzzy, nomatch, nodata Matches city submitted against the value in the source of truth.
postalCodeMatch exact, fuzzy, nomatch, nodata Matches postal code submitted against the value in the source of truth.
fullAddressMatch exact, fuzzy, nomatch, nodata Composite of streetMatch, cityMatch, and postalCodeMatch. See below for calculation logic.
phoneMatch exact, fuzzy, nomatch, nodata Matches phone submitted against the value in the source of truth.
overallLevel low, medium, high Overall risk level. See below for calculation logic.

overallLevel calculation

overallLevel is calculated based on the risk associated with the submitted full name and phone number:

  • low when fullNameMatch and phoneMatch are both exact.
  • high when fullNameMatch or phoneMatch is nomatch.
  • medium for all other combinations.

Contact your Incode representative to customize the overallLevel calculation for your use case.

Sample response

{
    "kyc": [
        { "key": "firstNameMatch", "status": "exact" },
        { "key": "lastNameMatch", "status": "exact" },
        { "key": "fullNameMatch", "status": "exact" },
        { "key": "streetMatch", "status": "exact" },
        { "key": "cityMatch", "status": "exact" },
        { "key": "postalCodeMatch", "status": "exact" },
        { "key": "fullAddressMatch", "status": "exact" },
        { "key": "phoneMatch", "status": "nomatch" },
        { "key": "overallLevel", "status": "low" }
    ]
}

Was this page helpful?