---
title: "Italy"
url: "https://developer.incode.com/general-reference/ekycitaly/"
section: "general-reference"
group: "eKYC Reference / eKYC Coverage"
version: "v1.1"
status: "live"
---
# Italy
Italy eKYC verification matches submitted individual data against Italy's official civil register, credit, and telco records. See the [eKYC API Reference](/general-reference/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

```json
{
    "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](/general-reference/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

```json
{
    "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" }
    ]
}
```

<br />